HTTP-коды
| Код | Значение | Что делать |
|---|---|---|
| 200/201 | Успех | — |
| 400 | Некорректный запрос | Проверить тело/параметры по Swagger |
| 401 | Ошибка авторизации | Проверить accountId/token (Аутентификация) |
| 403 | Нет прав | Проверить ключ и роль |
| 404 | Объект не найден | Проверить ID |
| 409/202 | Асинхронная задача ещё выполняется | Повторить запрос позже |
| 429 | Rate limit | Экспоненциальный бэкофф |
| 500/502/503/504 | Сбой платформы | Ретрай с бэкоффом |
Ретраи
Ретраить безопасно: GET, а также POST, если вы используете идемпотентный внешний ID (например, externalId в платежах). Рекомендуемая схема:
- задержки 3с → 10с → 30с → 60с (до 5–7 попыток);
- ретраить 429, 500, 502, 503, 504 и таймауты;
- не ретраить 400/401/403/404 — это ошибки интеграции.
const delays = [3000, 10000, 30000, 60000];
Платформа периодически отвечает 500 «Error processing request» короткими «плохими фазами» — ретраи с бэкоффом переживают большинство из них.
requestId
При обращении в поддержку по проблеме API прикладывайте accountId, метод, код ответа и requestId из заголовков ответа — так инженеры найдут запрос в логах.
Rate limits
При 429 снижайте параллелизм запросов. Массовые операции (много документов) делайте последовательно или используйте batch-методы (lsp/prices/batch, lsp/services/batch).