Помилки, за якими можна розгалужуватися

Кожна помилка — це problem details за RFC 9457: стабільний URL у type, що веде на її рядок нижче, HTTP-статус, detail з тим, що виправити, id запиту в instance і suggestions, якщо є близький збіг.

Відкрити довідник

404 application/problem+json

{
  "type": "https://arbitron.app/developers/errors#unknown-coin",
  "title": "Unknown coin",
  "status": 404,
  "detail": "No venue quotes a perpetual on 'ETHEREUM'. GET /api/v1/coins?q=ETHEREUM lists close matches.",
  "instance": "0HN7Q2K3J9R4P:00000001",
  "code": "unknown-coin",
  "docs": "https://arbitron.app/developers/errors",
  "suggestions": ["ETH", "ETC", "ETHFI"]
}

Усі коди помилок

400 invalid-parameter

Значення параметра поза діапазоном або не тієї форми. detail називає параметр і допустимі значення.

401 unauthenticated

Ключа немає, або він з помилкою, відкликаний, прострочений чи виведений ротацією. Передайте Authorization: Bearer з ключем зі сторінки «ШІ-асистенти та API».

403 scope-missing

Ключ створено без scope, який потрібен цьому ендпоінту; detail перелічує його scope. Створіть ключ із потрібним scope.

403 plan-limit

Запит виходить за план: вікно історії глибше, ніж він включає, або сторінка більша, ніж віддає демо. Звузьте запит або перейдіть на вищий план.

404 unknown-coin

Жодна біржа не котирує перп з таким тікером. У suggestions близькі збіги, а GET /api/v1/coins?q= шукає.

404 unknown-exchange

Такої біржі API не обслуговує. У suggestions список бірж, його ж віддає GET /api/v1/exchanges.

404 unknown-card

Жодна картка цього акаунта не має такого card_ref. Візьміть card_ref із GET /api/v1/me/cards: він дійсний лише для вашого акаунта.

404 not-found

За цим шляхом під /api/v1 немає ендпоінту. GET /api/v1 перелічує наявні.

429 rate-limited

Вікно хвилини вичерпано, або з однієї адреси надійшло забагато відхилених ключів. Зачекайте Retry-After секунд або тримайте темп за заголовком RateLimit.

429 quota-exhausted

Запити місяця витрачено. Квота обнуляється 1-го числа о 00:00 UTC; у вищого плану запитів більше.

503 snapshot-unavailable

Знімок за ендпоінтом ще прогрівається після перезапуску. Повторіть за хвилину.

503 api-disabled

API не ввімкнено на цьому хості. З вашого боку міняти нічого, це помилка конфігурації з нашого.