API-CLOUD - API РСА (Российский Союз Страховщиков)
Документация по работе с API РСА (Российский Союз Страховщиков)

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.
Отправьте запрос HTTP GET на URL нашего API: https://api-cloud.ru/api/rsa.php с персональным ключом API и параметрами.
Пример отправки GET запроса на PHP:
function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120);
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/rsa.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON
История изменений/обновлений
type (тип) Описание Параметры в запросе
В одном запросе возможно отправить только 1 тип
kbm Проверка КФ бонус/малус (Определить КБМ возможно только для водителей – граждан РФ)
• Вывод коэффициента бонус/малус
• Вывод страховых возмещений
Обязательные
surname - Фамилия водителя
Разрешено: кириллица, латиница, цифры, знак "-"
name - Имя водителя
Разрешено: кириллица, латиница, цифры, знак "-"
patronymic - Отчество водителя
Разрешено: кириллица, латиница, цифры, знак "-"
birthday - День рождения водителя
В формате 22.12.2020 (дд.мм.гг). Разрешено: цифры, знак "."
driverDocSeries - Серия документа водителя
Разрешено: кириллица, латиница, цифры
driverDocNumber - Номер документа водителя
Разрешено: кириллица, латиница, цифры
token - персональный ключ API

Дополнительные
date - на какую дату получить информацию
В формате 22.12.2020 (дд.мм.гг), по умолчанию текущая дата запроса.
Разрешено: цифры, знак "."
kbmLegal Проверка КФ бонус/малус юридического лица (Определить КБМ возможно только для юридических лиц – резидентов РФ)
• Вывод коэффициента бонус/малус юридического лица
• Вывод страховых возмещений
Обязательные
inn - ИНН собственника юридического лица
Разрешено: цифры. Не более 12 знаков.
token - персональный ключ API

Дополнительные
innLast - прошлый ИНН собственника ТС если он изменялся
Разрешено: цифры. Не более 12 знаков.
osago Поддержка приостановлена Проверка существующих полисов ОСАГО
• Серия ОСАГО
• Номер ОСАГО
• Наименование страховой компании
• Статус договора
• Срок действия и период использования транспортного средства договора ОСАГО
• Марка и модель транспортного средства
• Государственный регистрационный знак
• VIN номер
• Мощность двигателя для категории B, л.с.
• Транспортное средство следует к месту регистрации или к месту проведения технического осмотра
• Управление транспортным средством с прицепом
• Цель использования транспортного средства
• Договор ОСАГО с ограничениями/без ограничений лиц
• Страхователь
• Собственник
• Дата актуальности
Обязательные
vin - VIN номер или regNumber - регистрационный номер или bodyNumber - номер кузова
Разрешено для VIN: латиница, цифры
Разрешено для regNumber: кириллица, цифры
Разрешено для bodyNumber: латиница, цифры
token - персональный ключ API
Дополнительные
date - на какую дату получить информацию
В формате 22.12.2020 (дд.мм.гг), по умолчанию текущая дата запроса
osagochek Поддержка приостановлена Проверка полиса ОСАГО по серии и номеру
• Серия ОСАГО
• Номер ОСАГО
• Наименование страховой компании
• Статус договора
• Срок действия и период использования транспортного средства договора ОСАГО
• Марка и модель транспортного средства
• Государственный регистрационный знак
• VIN номер
• Мощность двигателя для категории B, л.с.
• Транспортное средство следует к месту регистрации или к месту проведения технического осмотра
• Управление транспортным средством с прицепом
• Цель использования транспортного средства
• Договор ОСАГО с ограничениями/без ограничений лиц
• Страхователь
• Собственник
• Дата актуальности
Обязательные
seria - Серия полиса
nomer - Номер полиса
Разрешено для seria: кирилица
Разрешено для nomer: цифры
token - персональный ключ API
Примеры запросов


История изменений API Российский Союз Автостраховщиков (РСА)

дата что изменилось
22.04.2023

Метод запроса kbm: Адаптирован под источник.

14.12.2022

Пересмотрели алгоритм работы с другой стороны. Выявили недочеты, которые в итоге привели к ускорению работы API.

20.11.2022

В результате запроса osagochek добавили массив intelligence с информацией о изменениях полиса ОСАГО.
В документацию внесли изменения.

12.11.2022

В методе запроса osagochek исправили ошибку NO_RESULTAT

07.11.2022

Через метод запроса osago исправили ошибку, связанную с отказом приема свойства regNumber

23.10.2022

В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса. 

10.10.2022

Пофиксили пустой ответ по типу запроса osago

19.09.2022

По типу запроса "osago" поправили ошибку при которой в некоторые моменты возникало отсутствие полиса, при его существовании.

20.07.2022

Исправили работу osagochek. Работает корректно.

19.07.2022

1. Запущена работа в улучшенном алгоритме. Ускорена работа.
2. Вывод из кэша теперь работает только при передаче параметра cache=1
При использовании данного параметра скорость получения ответа может быть уменьшена.

06.07.2022

type->kbm, добавили вывод страховых возмещений.

17.02.2022

Добавлен новый тип запроса "kbmLegal"
Вывод коэффициента бонус/малус юридического лица по ИНН

01.02.2022

type->osago, обязательные параметры
Добавлена проверка на обязательные параметры в запросе. В запросе должны присутствовать обязательные параметры, иначе возникнет ошибка №766 с текстом "MISSING_MANDATORY_PARAMETER"

18.11.2021

ТРЕБУЕТСЯ ДОРАБОТКА ВАШЕГО КОДА
Архитектура ответа type->osago и type->osagochek
Массив с результатами перенесен в переменную rez. Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток

26.10.2021

Ошибка type->osago
Из-за нового параметра bodyNumber возникала ошибка PARAMETER_CONFLICT

15.10.2021

Новый параметр поиска в type->osago
Доступен новый параметр bodyNumber для поиска полиса по номеру кузова

09.09.2021

Исправление
Ресурс источник изменил формат ответа. API приведен в соответствие.

06.09.2021

Описание новой ошибки
При возникновении проблем с ресурсом источником API отключается до решения вопроса по его восстановлению. В данном случае ответ: {"error":001,"message":"API_SUSPENDED","errormsg":"Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже."}

19.08.2021

Отловлен баг с пустым ответом ресурса в связи с загруженностью.
Проводятся дополнительные попытки получить ответ, если по истечению попыток результата нет, то возникает ошибка {"error":404,"message":"NO_RESULTAT","errormsg":"Ресурс не вернул никакого результата. Повторите запрос."}.
Средства возвращаются на баланс.

29.07.2021

1. Пофиксили баг, который возникал когда в РСА присутствовало более 1 активного полиса
2. В вывод добавили параметр maxMassa - Максимальная разрешенная масса для категории С, кг

23.07.2021

Добавили новый тип запроса type -> osagochek
Позволяет произвести поиск по серии и номеру полиса ОСАГО

22.07.2021

Переделали алгоритм запроса данных. Увеличили скорость ответа.

03.06.2021

При запросе type -> osago добавили вывод результата в случае отсутствия информации о полисе
{"status":200,"count":0,"message":"Сведения о договоре ОСАГО с указанными данными не найдены"}

21.05.2021

Пофиксили вывод результата type=osago. Ранее если был номер кузова указан или отсутствовала мощность, то весь запрос выводился некорректно. Переделали архитектуру.
Добавили параметр вывода: numberID - номер полиса, kuzovNumber - номер кузова (если указан)

11.05.2021

В type=osago добавлен параметр regNumber. Поиск по регистрационному номеру ТС

07.05.2021

1. Пофиксили пустой ответ []
2. Пофиксили вывод после VIN номера. Обнаружили дополнительное поле "Номер кузова, которое сбивало вывод"

17.04.2021

Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен.
Код ошибки: 999. SERVICE_CAPTCHA_OFFLINE

Возможные коды ошибок

код (error) Описание ошибки (message)
888 ИМЯ передаваемой переменной: forbidden symbols present
В переменной ИМЯ присутствуют запрещенные символы
784 MISSING_REQUIRED_INN_PARAMETER
Отсутствует параметр inn или указан неверно
766 MISSING_MANDATORY_PARAMETER
Отсутствуют обязательные параметры
708 patronymic: forbidden symbols present
В параметре patronymic присутствуют запрещенные символы
707 name: forbidden symbols present
В параметре name присутствуют запрещенные символы
706 surname: forbidden symbols present
В параметре surname присутствуют запрещенные символы
705 MISSING_REQUIRED_DRIVERDOCNUMBER_PARAMETER
Отсутствует параметр driverDocNumber (Номер удостоверения водителя)
704 MISSING_REQUIRED_DRIVERDOCSERIES_PARAMETER
Отсутствует параметр driverDocSeries (Серия удостоверения водителя)
703 MISSING_REQUIRED_BIRTHDAY_PARAMETER
Отсутствует параметр BIRTHDAY (День рождения)
702 MISSING_REQUIRED_PATRONYMIC_PARAMETER
Отсутствует параметр PATRONYMIC (Отчество)
701 MISSING_REQUIRED_NAME_PARAMETER
Отсутствует параметр NAME (Имя)
700 MISSING_REQUIRED_SURNAME_PARAMETER
Отсутствует параметр SURNAME (Фамилия)
602 TOKEN_NO_ACCESS
Нет доступа к запрашиваему методу запроса
505 MISSING_REQ_REGNUM_STS_PARAM
Отсутствует обязательная связка параметров Регистрационный номер (regNumber) и/или Номер СТС (stsNumber)
504 TOKEN_LOCKED_IN_THE_SYSTEM
Переданный токен заблокирован службой качества / автоматической системой
503 TOKEN_NOT_REGISTERED_IN_THE_SYSTEM
Переданный токен не зарегистрирован в системе
502 MISSING_REQUIRED_TOKEN_PARAMETER
Отсутствует параметр token
501 MISSING_REQUIRED_SERIA-NOMER_PARAMETER
Отсутствует параметр seria/nomer или указан неверно
500 MISSING_REQUIRED_TYPE_PARAMETER
Отсутствует параметр type
499 WRONG_TOKEN_KEY
Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498 TOKEN_NO_MONEY
Для выполнения запроса недостаточно средств, пополните баланс.
460 NO_REQUIRED_PARAMETERS
Отсутствуют обязательные параметры
456 MAX_LIMIT
Превышено количество одновременных соединений (потоки)
404 TIME_MAX_CONNECT
Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123 IP_NOT_REGISTERED_IN_THE_SYSTEM
Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111 PARAMETER_CONFLICT
Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
015 DATE_ERROR
Ошибка значения переданной даты
005 TEST_TIME_OFF
Закончился период тестирования
001 API_SUSPENDED
Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.
Пример ответа с ошибкой

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

• API ГИБДД (Государственная инспекция безопасности дорожного движения)

• API Федеральная Таможенная Служба (ФТС)

• API VIN Декодер (Расшифровка данных VIN номера)

• API РСА (Российский Союз Автостраховщиков)

• API ЕАИСТО (Единая Автоматизированная Информационная система технического осмотра)

• API ФССП (Федеральная Служба Судебных Приставов)

• API Отзывные компании

• API Проверка ТС по базе такси

• API Фотографии транспортных средств

• API Каталог фотографий авто

• API Оценка стоимости автомобиля

• API МВД (Министерство Внутренних дел)

• API ФРИ (Федеральный реестр инвалидов)

• API Федеральная налоговая служба

• API Московский транспорт (transport.mos.ru)

• API Федеральный ресурс (Банкротства)

• API Росреестр

• API Bidcars (История автомобилей из США с аукционов Copart и IAAI)

• API Электронный ПТС

• API Номерограм

• API Скриншот сайта

• API Росфинмониторинг

• API Конвертер VIN<->Рег.номер

• API API ras.arbitr (Решения арбитражных судов)

• API kad.arbitr (Картотека арбитражных дел)

• API Реестр залогов

Обращаем ваше внимание, что API-CLOUD не имеет никакого отношения к ресурсам источникам*, а предоставляет вам более удобный способ взаимодействия с информацией, находящейся в открытом доступе на данных ресурсах.
API Реестр залогов API ГИБДД API Федеральная Таможенная Служба (ФТС) API VIN Декодер API Картотека арбитражных дел API Федеральная служба судебных приставов (ФСПП) API Отзывные компании транспортных средств API Российский Союз Автостраховщиков (РСА) API Фотографии транспортных средств API Каталог фотографий авто API Лицензии такси API Конвертация из VIN в регистрационный номер и наоборот API Оценка стоимости автомобиля API МВД (Министерство Внутренних дел) API ФРИ (Федеральный реестр инвалидов) API Федеральная налоговая служба API Московский транспорт (transport.mos.ru) API Федеральный ресурс (Банкротства) API Росреестр API Bidcars (История автомобилей из США с аукционов Copart и IAAI) API Электронный ПТС API Номерограм API Скриншот сайта API Росфинмониторинг API Конвертер VIN<->Рег.номер API arbitr