RealIQДанные · Риски · Решения

API и интеграции

Ошибки, лимиты и баланс в API

API RealIQ возвращает не только HTTP-статус, но и публичный error_code. Это нужно, чтобы ваша система могла показать пользователю понятное действие.

Обновлено: 28.06.2026 · 7 минут

APIошибкилимитыбаланс

Порядок действий

Что сделать

  1. invalid_api_key, revoked_api_key или expired_api_key означают проблему с ключом.
  2. scope_denied означает, что у ключа нет доступа к нужному методу.
  3. insufficient_funds означает, что для запуска в боевом режиме не хватает баланса.
  4. rate_limited означает превышение лимита частоты или параллельности.
  5. source_unavailable означает, что внешний источник временно недоступен.

На что обратить внимание

Практические замечания

  • Не показывайте пользователю внутренние технические детали. Переводите error_code в понятное действие.
  • Используйте /api/v1/checks/quote перед запуском проверки и /api/v1/balance для сверки баланса.
  • Rate limit — это не ошибка источника, а ограничение вашей интеграции.