Ошибки
Любая ошибка имеет одну и ту же форму. message приходит на языке, заданном в lang, а docs ведёт к объяснению ниже. Ошибка не стоит кредитов.
Форма ошибки
{
"error": {
"code": "quota_exceeded",
"message": "Вы использовали все кредиты периода.",
"docs": "https://developer.satelit.md/en/errors/#quota_exceeded"
}
}401auth_required
Когда возникает: В вызове нет ключа.
Что делать: Отправьте Authorization: Bearer sat_live_… или X-Api-Key.
401key_invalid
Когда возникает: Ключ неизвестен или отозван. После 30 неверных попыток в минуту с одного IP ответ становится 429.
Что делать: Проверьте ключ в панели. Если он отозван, создайте другой.
402plan_required
Когда возникает: У аккаунта нет плана, или в вашем плане этого нет: вебхуки, поток, экспорт. Поле choose ведёт на страницу цен.
Что делать: Выберите план на странице цен и запросите его из панели. Отклонённый запрос ничего не стоит.
403not_available
Когда возникает: Источники этого продукта сейчас недоступны в API.
Что делать: Посмотрите страницу статуса или напишите на hello@satelit.md.
403account_suspended
Когда возникает: Аккаунт приостановлен администратором.
Что делать: Напишите нам на hello@satelit.md.
404not_found
Когда возникает: Маршрута или строки не существует.
Что делать: Проверьте адрес и идентификатор в справочнике.
405method_not_allowed
Когда возникает: Вы использовали метод, отличный от GET, HEAD или OPTIONS.
Что делать: Используйте GET. API только читает.
422invalid
Когда возникает: Неверный параметр. Поле fields сообщает, какой именно.
Что делать: Исправьте параметры из fields. Форматы описаны в справочнике.
429rate_limited
Когда возникает: Вы превысили лимит плана в минуту.
Что делать: Подождите столько секунд, сколько указано в Retry-After, и повторите вызов.
429quota_exceeded
Когда возникает: Вы использовали все кредиты периода.
Что делать: Дождитесь сброса, указанного в X-Credits-Reset, или запросите план побольше. Дополнительных счетов нет.
503busy
Когда возникает: У сервиса слишком много ответов в обработке или база данных не отвечает.
Что делать: Подождите столько секунд, сколько указано в Retry-After, и повторите вызов.