Быстрый поиск промокода

Ищет код по полному или частичному значению (нормализованная строка).

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

Ищет код по полному или частичному значению (нормализованная строка). Нужен службе поддержки: «проверить код клиента за 1 секунду».

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

Поле быстрого поиска в шапке раздела «Промокоды», интеграции с CRM.

Эндпоинт

POST /v1/internal/inventory-promo-codes/search

Аутентификация: JWT — заголовок Authorization: Bearer <token>. Пользователь должен иметь доступ к проекту и permission inventory_promo_codes.

Permission: inventory_promo_codes.view

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2…", "query": "QUEEN14-48AMU" }
}

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "code-uuid",
        "codeDisplay": "QUEEN14-48AMU",
        "status": "realized",
        "supplierName": "Промомед",
        "platformId": "platform-uuid"
      }
    ],
    "totalCount": 1
  }
}

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/inventory-promo-codes/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2…", "query": "QUEEN14-48AMU" }}'