insufficient_balance

ПричинаСкопировать ссылку

Баланс организации исчерпан: страниц не хватает либо сразу при запросе (ответ 402), либо позже — после пересчёта по факту обработки (ошибка прогона insufficient_balance).

Что делатьСкопировать ссылку

Пополните баланс в Кабинете (раздел «Баланс») или запросите счёт для юрлица на billing@typizer.ru.

Повтор не поможет: сначала устраните причину — тот же запрос вернёт ту же ошибку.

Пример ответаСкопировать ссылку

API отвечает HTTP-статусом 402 и телом application/problem+json (RFC 9457), в поле code — insufficient_balance. Ветвитесь по code; detail — текст для человека, param — поле запроса, если ошибка относится к нему, request_id — передайте его в поддержку.

{
  "type": "https://docs.typizer.ru/errors/insufficient_balance",
  "title": "Insufficient balance",
  "status": 402,
  "detail": "Insufficient balance",
  "code": "insufficient_balance",
  "request_id": "req_0196f3a2-8b1c-7d4e-9a5f-1c2d3e4f5a6b",
  "doc_url": "https://docs.typizer.ru/errors/insufficient_balance"
}

В прогонеСкопировать ссылку

Тот же код приходит и в поле run.error.code прогона, завершившегося неудачей. HTTP-статуса у него нет — прогон асинхронный (как получить результат — «Получить результат»). message — текст для человека, он может меняться: ветвитесь по code.

{
  "id": "run_01jvst52rwfn79mqrw5mz4ypkb",
  "object": "run",
  "status": "failed",
  "error": {
    "code": "insufficient_balance",
    "message": "…"
  }
}

Связанные кодыСкопировать ссылку

• too_many_pages — Слишком много страниц

Все коды — в таблице «Коды ошибок».