api

Уважаемые партнеры, владельцы или разработчики web сайтов, наш центр обработки предоставляет программный интерфейс (API) для неограниченных по времени и количеству запросов к базам РСА и ЕАИСТО. Полученные данные можно например использовать для создания у себя на сайте проверок, аналогичных нашим.

Условия предоставления:  для партнеров - бесплатно,  кроме необходимости разместить ссылку на главной странице своего сайта на https://kbm-osago.online ; для сторонних клиентов - разовый взнос в размере 10000 руб. Окажем бесплатную помощь в интеграции нашего API или на платной основе  разработаем для вас необходимые формы и сервисы. 

Чтобы получить доступ к программному интерфейсу или консультацию,  подайте заявку , мы ответим в течение 24 часов.

Ниже описание части функционала программного интерфейса.

Пример API к ЕАИСТО:
С вашей стороны происходит GET запрос для получения данных в виде Json строки
$url="https://kbm-osago.online/api.php?eaisto&type=regNumber&data=Х001ХХ77";
или для получения данных в виде текста (в url запроса добавляется &text)
$url="https://kbm-osago.online/api.php?eaisto&type=regNumber&data=Х001ХХ77&text";
возможные значения type: regNumber -> госномер, vin -> вин номер, BodyNumber -> номер кузова, FrameNumber -> номер шасси, formNumber -> номер в ЕАИСТО. В значении data можно использовать как строчные, так и заглавные буквы. В госномере всегда русские буквы, в вин, номере шасси или кузова - английские.
получение результата

$result = file_get_contents($url);
преобразование результата в массив, если тип запроса Json
print_r(json_decode($result));
так выглядит преобразованный в массив результат Json запроса
Array ( [0] => stdClass Object ( [Id] => 160668014 [IsArchive] => 0 [BodyNumber] => WVWZXX3BX1P000001 [DateOfDiagnosis] => 2018-05-07T00:00:00 [Form] => stdClass Object ( [Duplicate] => [Number] => 069990000000015 [Series] => [Type] => DK [Validity] => 2019-05-07T00:00:00 ) [Name] => [RegistrationNumber] => Х001ХХ77 [TestResult] => Passed [Values] => [Vehicle] => stdClass Object ( [Make] => Volkswagen [Model] => Passat ) [VehicleCategory] => B [VehicleCategory2] => M1 [Vin] => WVWZXX3BX1P000001 [FrameNumber] => [Expert] => stdClass Object ( [Name] => Иванов [FName] => Артем [MName] => Петрович ) [Operator] => stdClass Object ( [FullName] => ИП Иванов Сергей Петрович [ShortName] => 00004 (z) Иванов С.П. ) ) )
или непосредственный вывод, если тип запроса был текстовый
echo $result;
так выглядит текстовый вывод результата:
Дата диагностики: 07.05.2018
Номер диагностической карты: 069990000000015
Действительна до: 07.05.2019
Марка и модель: Volkswagen Passat
Категория: B (M1)
Госномер: Х001ХХ77
VIN: WVWZXX3BX1P000001
Номер кузова: WVWZXX3BX1P000001
Номер шасси:


Пример краткой версии API КБМ водителя на текущую дату ("simple kbm" - метод s_kbm) :
С вашей стороны происходит GET запрос для получения данных в виде Json строки
$url="https://kbm-osago.online/api.php?s_kbm&data=".urlencode("Иванова Елена Ивановна#20.07.1977#21АВ 100008");
Получение цифрового значения КБМ водителя на текущую (всегда!) дату:
$result = file_get_contents($url); echo $result;

Пример API запроса КБМ в РСА, для юридических лиц и физических лиц (с ограничением и без ограничения):
С вашей стороны происходит GET запрос для получения данных в виде Json строки
$url="https://kbm-osago.online/api.php?getkbm&data=".urlencode("Иванова Елена Ивановна#20.07.1977#21АВ 100008#12.01.2018");
или для получения данных в виде текста (в url запроса добавляется &text)
$url="https://kbm-osago.online/api.php?getkbm&text&data=".urlencode("Иванова Елена Ивановна#20.07.1977#21АВ 100008#12.01.2018");
Для получения КБМ юридического лица в GET запрос добавляется параметр INN.
Пример API запроса КБМ в РСА для юридических лиц:

$url="https://kbm-osago.online/api.php?getkbm&INN=12345567890&data=".urlencode("VIN#XXX00001111222200#12.01.2018");
Значения data представляют собой закодированную строку с разделителем данных #. Порядок данных для получения КБМ по водителю: ФИО#Дата рождения#Серия и номер водительского удостоверения#Дата расчета КБМ (необязательно, при отстутствии расчет будет на текущую дату). Порядок данных для получения КБМ по собственнику-физлицу (ОСАГО без ограничений): ФИО#Дата рождения#Серия и номер паспорта гражданина РФ#Вид идентификатора автомобиля#Значение идентификатора#Дата расчета КБМ (необязательно). Порядок данных для получения КБМ юридического лица: #Вид идентификатора автомобиля#Значение идентификатора#Дата расчета КБМ (необязательно). Допустимые названия видов индентификаторов автомобиля: VIN -> вин номер, BodyNumber -> номер кузова, ChassisNumber - > номер шасси.
получение результата

$result = file_get_contents($url);
преобразование результата в массив, если тип запроса Json
print_r(json_decode($result));
так выглядит преобразованный в массив результат Json запроса
stdClass Object ( [IdRequestCalc] => 6328398478 [PolicyCalc] => stdClass Object ( [PolicySerialKey] => ЕЕЕ [PolicyNumberKey] => 0000940008 [PolicyKBM] => 5 [PolicyKBMValue] => 0.9 [InsurerName] => ИНГОССТРАХ ) [CalcKBMResponses] => stdClass Object ( [ErrorInfo] => stdClass Object ( [Code] => 3 [Message] => Обработан успешно ) [CalcKBMResponse] => stdClass Object ( [ErrorInfo] => stdClass Object ( [Code] => 3 [Message] => Обработан успешно ) [DriverDocument] => stdClass Object ( [Serial] => 21АВ [Number] => 100008 ) [Hash] => Иванова Елена Ивановна 20071977 [KBMFirstLevel] => 4 [KBMNextLevel] => 5 [KBMValue] => 0.9 [Losses] => stdClass Object ( ) ) ) )
или непосредственный вывод, если тип запроса был текстовый
echo $result;
так выглядит текстовый вывод результата:
ID запроса: 6328398478 Статус запроса: Обработан успешно Класс: 5 КБМ: 0.9 Полис ОСАГО: ЕЕЕ 0000940008 ИНГОССТРАХ
При добавлении в url GET запроса параметра &history, к результату добавляется история КБМ в базе РСА за последние 5 лет.
При типе запроса Json, в массив значений результата добавляется массив History, содержащий внутри себя 5 строк из массивов вида:

array([date]=> Дата начала года,[kbm]=>Значение КБМ, [policy]=>Серия и номер полиса ОСАГО, [insurer]=>Название страховой компании)
тип запроса текстовый, то история за последние 5 лет добавляется к результату в виде html таблицы.