Ошибки

Ошибки используют обычные коды статусов HTTP и всегда возвращают одинаковую JSON-обёртку со стабильным машинным кодом.

Формат ошибки#

{
  "error": {
    "code": "rateLimited",
    "message": "Rate limit exceeded",
    "retryAfter": 12
  }
}

error.code стабилен, на него можно опираться в коде. error.message — подсказка для человека, она может меняться. Некоторые ошибки добавляют поля: retryAfter для лимитов, reason для квот и ограничений тарифа, issues для ошибок валидации.

Коды ошибок#

Ошибки валидации#

Некорректные параметры возвращают 400 со списком issues, указывающих на проблемное поле.

{
  "error": {
    "code": "validation",
    "message": "Invalid input",
    "issues": [
      {
        "path": "pageSize",
        "message": "Invalid input"
      }
    ]
  }
}