Ошибки, по которым можно ветвиться

Каждая ошибка — это 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 не включён на этом хосте. С вашей стороны менять нечего, это ошибка конфигурации с нашей.