Перейти к основному содержимому

Partner OpenAPI + Postman

Опубликованные Partner-артефакты (подмножество Vendor Management):

АртефактСсылка
OpenAPI YAML/artifacts/openapi/partner.management.v1.yaml
OpenAPI JSON/artifacts/openapi/partner.management.v1.json
Postman/artifacts/postman/partner.management.v1.postman_collection.json

Включено​

  • /api/v1/service-accounts
  • /api/v1/licenses
  • /api/v1/devices
  • /api/v1/customers
  • Vendor Commerce: offers, price-books, orders, checkout-sessions (и coupons, если есть)

Коммерческая идентичность License​

Ответы списка/карточки License сохраняют assignedCustomerId и добавляют канонический alias customerOrganizationId; оба поля всегда содержат одно значение. Также доступны nullable-поля productId, customerSubscriptionId, offerVersionId, notes и строковые issueMode, migrationState. Для legacy строк identity-ссылки могут быть null: API не назначает Product неявно.

Коммерческая идентичность при создании​

POST /api/v1/licenses/ additive принимает productId, customerOrganizationId, customerSubscriptionId, offerVersionId, issueMode и notes. Историческое входное поле assignedCustomerId остаётся alias; если переданы оба customer-имени, значения должны совпадать.

  • Subscription требует Product, Customer, CustomerSubscription, OfferVersion и policyId.
  • IndividualGrant требует Product, Customer, policyId, аутентифицированного actor и доступный audit sink.
  • Без issueMode используется временный LegacyCompatibility, только пока на сервере включён compatibility switch.

Guard проверяет наличие identity. Точное соответствие commercial chain проверит последующая issue orchestration без cross-schema чтения в этом endpoint.

Исключено​

  • /api/v1/platform/* (Platform Owner)
  • /api/v1/billing/* (Platform Billing / PBL — Vendor→MyHoreca SaaS)
  • Входящие PSP webhook routes
  • Полный dump Management admin / Relay Host OpenAPI

Auth​

Задайте в Postman / клиенте переменную serviceAccountToken = once-revealed Bearer secret. Хост: https://management-api.<domain> (замените example host в артефакте).

PBL ≠ VCM​

Partner-автоматизация про Vendor Commerce (клиент платит вендору). Счета Platform Billing — другая поверхность и в этот OpenAPI не входят.

Связанное​