Полное значение промокода

Возвращает полный код для проверки жалобы клиента или сверки с ERP.

Зачем нужен метод

Возвращает полный код для проверки жалобы клиента или сверки с ERP. Каждый такой запрос логируется в audit (source=supplier_api).

Когда использовать

Только по обращению support — не для массовой выгрузки (используйте list с маской).

Эндпоинт

POST /v1/supplier/promo-codes/get

Аутентификация: API-ключ в заголовке X-Api-Key (префикс bk_sup_). projectId и actor id в body не передаются — берутся из ключа.

Scope: supplier:codes:read

Пример запроса

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "codeNormalized": "queen14-48amu" }
}

Пример ответа

{
  "success": true,
  "data": {
    "id": "code-uuid",
    "codeDisplay": "QUEEN14-48AMU",
    "codeNormalized": "queen14-48amu",
    "status": "realized",
    "productName": "Подписка 14",
    "validUntil": "2026-12-31T23:59:59Z",
    "realizedAt": "2026-07-01T10:00:00Z",
    "realizedChannel": "Ригла"
  }
}

Ошибки

UNAUTHORIZED / ACCESS_DENIED — нет доступа
VALIDATION_ERROR — некорректное тело
NOT_FOUND — сущность не найдена
RATE_LIMIT_EXCEEDED (429) — превышен лимит

cURL

curl -X POST "https://api-external.promanta.ru/v1/supplier/promo-codes/get" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"data": { "codeNormalized": "queen14-48amu" }}'