HTTPS GET запрос: https://api-cloud.ru/api/rsa.phpОбязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS. Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.
| type Обязательно |
Описание | Параметры в запросе Обязательно |
|---|---|---|
| В одном запросе возможно отправить только 1 тип | ||
| kbm | Проверка КФ бонус/малус (Определить КБМ возможно только для водителей – граждан РФ)
• Вывод коэффициента бонус/малус
|
Обязательные surname - Фамилия водителя Разрешено: кириллица, знак "-" name - Имя водителя Разрешено: кириллица, знак "-" birthday - День рождения водителя В формате 22.12.2020 (дд.мм.гг). Разрешено: цифры, знак ".". Минимальный возраст 16 лет. driverDocSeries - Серия документа водителя Разрешено: кириллица, цифры - минимум 4 символа driverDocNumber - Номер документа водителя Разрешено: цифры - минимум 6 символов token - персональный ключ API Дополнительные patronymic - Отчество водителя Разрешено: кириллица |
| osago | Проверка существующих полисов ОСАГО Обратите внимание, в данный момент НСИС возвращает VIN и гос номер в виде маски, с ****
• Серия ОСАГО
• Номер ОСАГО
• Наименование страховой компании
• Статус договора
• Марка и модель транспортного средства
• Государственный регистрационный знак
• VIN номер
|
Обязательные vin - VIN номер или regNumber - регистрационный номер или bodyNumber - номер кузова Разрешено для VIN: латиница, цифры Разрешено для regNumber: кириллица, цифры Разрешено для bodyNumber: латиница, цифры token - персональный ключ API Дополнительные date - на какую дату получить информацию В формате 22.12.2020 (дд.мм.гг), по умолчанию текущая дата запроса |
| osagochek | Проверка полиса ОСАГО по серии и номеру Обратите внимание, в данный момент НСИС возвращает VIN и гос номер в виде маски, с ****
• Серия ОСАГО
• Номер ОСАГО
• Наименование страховой компании
• Статус договора
• Марка и модель транспортного средства
• Государственный регистрационный знак
• VIN номер
|
Обязательные seria - Серия полиса nomer - Номер полиса Разрешено для seria: кирилица Разрешено для nomer: цифры token - персональный ключ API |
function get_rez($url) {
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ
$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)
https://api-cloud.ru/api/rsa.php?type=kbm&surname=Кочура&name=Александр&patronymic=Васильевич&birthday=31.03.1994&driverDocSeries=9902&driverDocNumber=5513333&token=53ba1b7a55abbB014aa97eff3a522079
{
"status": 200, // Статус ответа
"kbmValue": "0.78", // Значение КБМ
"inquiry": {
"price": 0.5,
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 17,
"attempts": 1
}
}
{"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}
Что делать в такоем случае? Повторите запрос.
https://api-cloud.ru/api/rsa.php?type=osago&vin=VF34C5*****70236&token=53ba1b7a55abbB014aa97eff3a522079
{
"status":200, // Статус ответа
"count":1, // Количество результата
// Массив с данными полисов
"rez":[
{
"numberID": "1", // Порядковый номер ОСАГО
"seria": "РРР", // Серия ОСАГО
"nomer": "505****007", // Номер ОСАГО
"orgosago": "ПАО \"АСКО-СТРАХОВАНИЕ\"", // Наименование страховой организации
"status": "Действует", // Статус договора ОСАГО
"term": "10.07.2025 - 09.07.2026", // Срок действия и период использования транспортного средства договора ОСАГО
"termStart": "10.07.2025 ", // Начало периода использования
"termStop": " 09.07.2026", // Конец периода использования
"startPolis": "09.07.2025", // Начало действия договора
"stopPolis": "10.07.2026",// Окончание действия договора
"brandmodel": "Peugeot 308", // Марка и модель транспортного средства
"regnum": "С8****3", // Государственный регистрационный знак
"vin": "VF34*******170236", // VIN
"dopbelarus": "Нет" // Расширение на территорию Республики Беларусь (Да/Нет)
}
],
// Фильтры поиска
"filters": {
"date": "08.08.2025" // На какую дату получаем информацию
},
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200, // Статус ответа
"count":0, // Количество результата
"message":"Сведения о договоре ОСАГО с указанными данными не найдены",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/rsa.php?type=osagochek&seria=ХХХ&nomer=111111&token=53ba1b7a55abbB014aa97eff3a522079
{
"status":200, // Статус ответа
"count":1, // Количество результата
// Массив с данными полисов
"rez":[
{
"numberID": "1", // Порядковый номер ОСАГО
"seria": "РРР", // Серия ОСАГО
"nomer": "505****007", // Номер ОСАГО
"orgosago": "ПАО \"АСКО-СТРАХОВАНИЕ\"", // Наименование страховой организации
"status": "Действует", // Статус договора ОСАГО
"term": "10.07.2025 - 09.07.2026", // Срок действия и период использования транспортного средства договора ОСАГО
"termStart": "10.07.2025 ", // Начало периода использования
"termStop": " 09.07.2026", // Конец периода использования
"startPolis": "09.07.2025", // Начало действия договора
"stopPolis": "10.07.2026",// Окончание действия договора
"brandmodel": "Peugeot 308", // Марка и модель транспортного средства
"regnum": "С8****3", // Государственный регистрационный знак
"vin": "VF34*******170236", // VIN
"dopbelarus": "Нет" // Расширение на территорию Республики Беларусь (Да/Нет)
}
],
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200, // Статус ответа
"count":0, // Количество результата
"message":"Сведения о договоре ОСАГО с указанными данными не найдены",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
| дата | что изменилось |
|---|---|
| 01.08.2025 | Методы osago и osagochek: В результате добавлен новый ключ stopPolis (Окончание действия договора) |
| 31.07.2025 | Методы osago и osagochek: |
| 23.02.2025 | Метод kbm: Добавлена проверка возраста водителя (birthday). Минимальный возраст 16 лет. Если возраст меньше, то будет ошибка MISSING_REQUIRED_BIRTHDAY_PARAMETER |
| 02.10.2024 | 01.10.2024 в тестовом режиме запущены методы osago, osagochek. Получение информации с НСИС. |
| 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. Запущена работа в улучшенном алгоритме. Ускорена работа. |
| 06.07.2022 | type->kbm, добавили вывод страховых возмещений. |
| 17.02.2022 | Добавлен новый тип запроса "kbmLegal" |
| 01.02.2022 | type->osago, обязательные параметры |
| 18.11.2021 | ТРЕБУЕТСЯ ДОРАБОТКА ВАШЕГО КОДА |
| 26.10.2021 | Ошибка type->osago |
| 15.10.2021 | Новый параметр поиска в type->osago |
| 09.09.2021 | Исправление |
| 06.09.2021 | Описание новой ошибки |
| 19.08.2021 | Отловлен баг с пустым ответом ресурса в связи с загруженностью. |
| 29.07.2021 | 1. Пофиксили баг, который возникал когда в РСА присутствовало более 1 активного полиса |
| 23.07.2021 | Добавили новый тип запроса type -> osagochek |
| 22.07.2021 | Переделали алгоритм запроса данных. Увеличили скорость ответа. |
| 03.06.2021 | При запросе type -> osago добавили вывод результата в случае отсутствия информации о полисе |
| 21.05.2021 | Пофиксили вывод результата type=osago. Ранее если был номер кузова указан или отсутствовала мощность, то весь запрос выводился некорректно. Переделали архитектуру. |
| 11.05.2021 | В type=osago добавлен параметр regNumber. Поиск по регистрационному номеру ТС |
| 07.05.2021 | 1. Пофиксили пустой ответ [] |
| 17.04.2021 | Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен. |
| код (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, что-то одно. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}