Ошибки, квоты и лимиты

Конверт ошибки, коды статуса и поведение при сбоях квот/биллинга.

1 мин чтения Разделов: 3

Конверт ошибки#

Ответы с ошибкой содержат поля error, message, statusCode и requestId.

Ответ с ошибкой

{
  "error": "ForbiddenError",
  "message": "Требуются разрешения: links:write",
  "statusCode": 403,
  "requestId": "…"
}

Коды статуса#

Код	Значение
`400`	Недопустимое тело запроса или курсор
`401`	Ключ отсутствует, недействителен, отозван или истёк
`403`	Отсутствует необходимый scope
`409`	Конфликт идемпотентности (тот же ключ, другой payload)
`429`	Квота превышена; подождите время, указанное в `Retry-After`
`503`	Мутация во время сбоя биллинга; повторите с тем же ключом идемпотентности

Квоты#

Каждый вызов developer API учитывается в вашем ежемесячном потреблении monthlyApiCalls; операции со ссылками, tree, board, маршрутами и событиями дополнительно расходуют ресурсные квоты тарифа. Идемпотентные повторы не увеличивают счётчики дважды. Текущее потребление можно посмотреть на вкладке «Использование» в консоли.

При сбое чтения/проверки биллинга запросы только на чтение продолжают работать в контролируемом режиме; только мутации останавливаются с кодом 503.

Чего-то не хватает или есть ошибка? Напишите в поддержку; приложив значение X-Request-Id из ответа, вы ускорите решение.