Ошибки

Формат

Ошибки приходят в едином конверте:

{
  "statusCode": 400,
  "message": "duration must be an integer number",
}
⧉

• statusCode — HTTP-код;
• message — строка или массив строк (ошибки валидации);
• code — машиночитаемый код (не всегда присутствует).

Коды

Валидация

Глобальный валидационный пайплайн отбрасывает неизвестные поля и приводит типы. Массив message перечисляет все нарушения сразу:

{
  "statusCode": 400,
  "message": [
    "duration must be an integer number",
    "resolution must be shorter than or equal to 16 characters"
  ]
}
⧉

Рекомендации по ретраям

• 429 — экспоненциальная задержка, начиная с 1–2 секунд; при наличии заголовка Retry-After ориентируйтесь на него.
• 5xx — повтор с задержкой; операции идемпотентны на стороне списаний, но перед повтором «запускающих» эндпоинтов генерации проверяйте статус задачи.
• 401/403 — не повторять: проверьте ключ.

⧉ Раздел в Markdown