Ошибки

Любая ошибка приходит в одном формате:

{
  "error": {
    "code": "invalid_api_key",
    "message": "Неверный или отозванный API-ключ",
    "status": 401,
    "request_id": "3f2b9c0e8d7a4e1f9b6c5d4a3e2f1a0b",
    "details": null
  }
}

request_id дублируется в заголовке ответа X-Request-Id. Если пишете в поддержку — приложите его: по нему находится ваш запрос.

Ориентируйтесь на code, а не на текст message — текст может меняться.

HTTP	code	Что значит	Что делать
400	key_in_query	ключ передан в адресе	отозвать ключ, выпустить новый, передавать заголовком
401	missing_api_key	нет заголовка Authorization: Bearer	добавить заголовок
401	invalid_api_key	ключ неверен или отозван	проверить ключ, выпустить новый
403	scope_missing	у ключа нет нужного права (details.required_scope)	выпустить ключ с этим правом
403	api_disabled	программный доступ для аккаунта ещё не открыт	дождаться открытия
403	account_locked	аккаунт ожидает удаления	отменить удаление в кабинете
404	not_found	нет такого адреса	проверить путь
422	validation_error	неверные параметры (details — какие)	исправить запрос
429	rate_limited	слишком часто	подождать и повторить
500	internal_error	сбой у нас	повторить позже, при повторе — в поддержку с request_id
502	upstream_error, upstream_unavailable	сервис временно недоступен	повторить позже
503	api_unavailable	программный доступ временно выключен	повторить позже
504	upstream_timeout	сервис не ответил вовремя	повторить