Ошибки

Каждая ошибка имеет форму:

{
  "error": {
    "type": "validation_error",
    "code": "invalid_request",
    "message": "due_date must be a valid ISO-8601 datetime",
    "request_id": "req_6a2918cff58b0a1d387866ee",
    "errors": [{ "field": "due_date", "message": "must be a valid ISO-8601 datetime" }]
  }
}

• type — стабильная широкая категория.
• code — стабильная машиночитаемая строка.
• request_id — указывайте его при обращении в поддержку.
• errors[] — детали по каждому полю для ошибок валидации (присутствуют только когда это релевантно).

Каталог

HTTP	type	code	Значение
401	authentication_error	unauthorized, expired	API-ключ отсутствует, недействителен, отозван или истёк.
403	permission_error	insufficient_scope	У ключа нет необходимого доступа, либо ресурс вне его scope.
404	not_found_error	resource_not_found	Ресурс не существует или не виден этому ключу.
409	conflict_error	already_exists	Ресурс уже существует, либо Idempotency-Key был повторно использован с другим телом запроса.
422	validation_error	invalid_request	Запрос не прошёл валидацию; см. errors[] для проблемных полей.
429	rate_limit_error	too_many_requests	Слишком много запросов; повторите после задержки, указанной в заголовке Retry-After.
500	api_error	internal_error	Непредвиденная ошибка сервера; можно безопасно повторить позже.

Ответы с ошибками также содержат doc_url, указывающий обратно на эту страницу.