Помилки
Кожна помилка має однакову форму. 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
Коли трапляється: Обліковий запис не має плану, або у вашому плані цього немає: webhooks, потік, експорт. Поле 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, і повторіть виклик.