Ошибки

HTTP статусы

  • 401 — отсутствует/неверный токен

  • 400 — неверный запрос (параметры/валидация)

  • 5xx — ошибка upstream/внутренняя ошибка

Единый формат ответа

Успех:

{
  "ok": true,
  "data": {}
}

Ошибка:

{
  "ok": false,
  "error": {
    "code": "invalid_request",
    "message": "Bad request",
    "details": null
  }
}

Частые коды ошибок

  • invalid_token — токен не принят (проверь заголовок Authorization)

  • invalid_request — неверные параметры/формат запроса

  • insufficient_funds — недостаточно средств

  • provider_error — временная ошибка upstream

  • internal_error — внутренняя ошибка сервиса

Рекомендации

  • Для provider_error / 5xx: сделай повтор через 10–30 секунд (1–3 попытки).

  • Для 400: исправь параметры (сверяйся с OpenAPI).

  • Для 401: проверь токен или сбрось его в боте и обнови в интеграции.