API ЦБ РФ

Документация по работе с API ЦБ РФ

Таймаут: Установите таймаут ожидания минимум 120–400 секунд.

Эндпоинт

GET https://ru-api.ru/api/cbr?type={type}&token={key}&...

Аутентификация

Получите персональный ключ API (32 символа) и передавайте его в параметре token с каждым запросом.

Типы запросов

type	Описание	Параметры
`license`	Лицензии ЦБ РФ Проверка лицензии кредитной организации по ИНН или регистрационному номеру	`inn` `regnumber`
`keyrate`	Ключевая ставка ЦБ РФ Текущая ключевая ставка (ставка рефинансирования) Банка России

* — обязательный параметр. Все запросы также требуют параметр token.

Формат ответа

Успех:

{
  "status": 200,
  "source": "cbr",
  "type": "тип_запроса",
  "num": 3,
  "rez": [ ... ],
  "inquiry": {
    "price": 1.50,
    "speed": "5.2 сек",
    "attempts": 1,
    "balance": 498.50,
    "cached": false
  }
}

Ошибка:

{"error": "503", "message": "TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

Пример запроса

curl "https://ru-api.ru/api/cbr?type=license&token=ВАШ_ТОКЕН"

Коды ошибок

Код	Описание
502	Отсутствует параметр token
503	Токен не зарегистрирован
499	Неверный формат токена
498	Недостаточно средств
500	Отсутствует параметр type
460	Отсутствуют обязательные параметры
404	Источник не найден
456	Превышен лимит одновременных соединений
1	API временно приостановлен