Коды ошибок

API Naumen Customer Engagement отвечает стандартными HTTP-кодами. Ниже — что означает каждый из них и что с ним делать.

Код	Значение	Что произошло и что делать
400	Bad Request	Запрос некорректен: не хватает обязательного параметра или нарушен формат. Проверьте тело и параметры запроса
401	Unauthorized	Неверный API-ключ. Проверьте shop_id
403	Forbidden	Метод только для внутреннего использования либо не передан секретный ключ. Проверьте shop_secret
404	Not Found	Запрошенный объект не найден
405	Method Not Allowed	Обращение выполнено неподходящим HTTP-методом
406	Not Acceptable	Запрошен формат ответа, отличный от JSON
429	Too Many Requests	Превышена частота запросов. Снизьте темп и повторите с экспоненциальной задержкой
500	Internal Server Error	Ошибка на стороне платформы. Повторите запрос позже
503	Service Unavailable	Идут технические работы. Повторите запрос позже

Повторные попытки

Коды 429, 500 и 503 — временные. Интеграцию имеет смысл сразу писать с повтором запроса и нарастающей паузой между попытками. Коды 4xx, кроме 429, повторять бесполезно: пока не исправлен сам запрос, ответ не изменится.

Авторизация

Все запросы авторизуются параметром shop_id — он идентифицирует магазин и передаётся и в GET, и в POST. Часть операций дополнительно требует секретный ключ shop_secret; такие методы вызываются только с сервера, ключ нельзя публиковать на фронтенде.

Подробнее — Авторизация.