API восстановления КБМ
API по восстановлению коэффициента бонус-малус (КБМ) по базе РСА расположен по адресу https://agent.kbm-pro.ru/API/
Также есть API проверки КБМ — описание доступно по ссылке
API восстановления КБМ поддерживает несколько методов:
- Создание заявки на исправление КБМ
- Получение текущего состояния сформированной ранее заявки
Перед использованием получите ключ API (кнопка «Получить/изменить ключ API» выше)
API принимает POST-запросы в кодировке UTF8.
Рекомендуем отправлять запросы с помощью библиотеки Curl.
Контакты для связи:
E-mail: support@kbm-pro.ru
Телеграм: @alex_dalen
1. Параметры (ключи) запроса на создание заявки:
- API — ключ API *
- fam — Фамилия *
- im — Имя *
- otch — Отчество *
- birthday — Дата рождения (в формате dd.mm.yyyy) *
- vod — Серия и номер ВУ (в формате ХХХХ ХХХХХХ) *
- old_vod — Предыдущие серия и номер ВУ (в формате ХХХХ ХХХХХХ) **
- old_fam — Предыдущая фамилия (не полностью ФИО, а только фамилия)
- pasp — На какую дату произвести расчёт (в формате dd.mm.yyyy)
- old_pasp — Комментарий к заказу
- passport — Серия и номер паспорта (в формате ХХХХ ХХХХХХ)
- Type — обязателен при подаче заявки на перенос КБМ. Может принимать одно значение — transfer
ВНИМАНИЕ! Параметры, отмеченные знаком * обязательно должны присутствовать в запросе!
Параметры, отмеченные знаком ** обязательны при Type=transfer!
Пример для подачи заявки на восстановление на PHP:
$url = 'https://agent.kbm-pro.ru/API/'; $post_data = array( 'API' => 'ASD!J@U#$^SHA!JAHA', 'fam' => 'Тестов', 'im' => 'Тест', 'otch' => 'Тестович', 'vod' => '0011 223344', 'birthday' => '22.10.1975' ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $output = curl_exec($ch); curl_close($ch); echo $output;
Пример для подачи заявки на перенос на PHP:
$url = 'https://agent.kbm-pro.ru/API/'; $post_data = array( 'API' => 'ASD!J@U#$^SHA!JAHA', 'fam' => 'Тестов', 'im' => 'Тест', 'otch' => 'Тестович', 'vod' => '0011 223344', 'birthday' => '22.10.1975', 'old_vod' => '9988 776655', 'Type' => 'transfer' ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $output = curl_exec($ch); curl_close($ch); echo $output;
На выходе Вы получите данные в формате JSON.
При успешном запросе в массиве ответа JSON Вы получите два значения:
- ‘success’ со значением ‘yes’,
- ‘OrderID’ с номером сформированной заявки
Например, {«success»:»yes»,»OrderID»:3747}
При ошибке в запросе в массиве ответа JSON Вы получите одно значение:
- ‘error’ с кодом ошибки и её кратким описанием
Например, {«error»:»Code 06. Not enough money for query»}
2. Параметры (ключи) запроса на проверку состояния заявки:
- API — ключ API *
- OrderID — номер заявки, полученный при её создании *
ВНИМАНИЕ! Параметры, отмеченные знаком * обязательно должны присутствовать в запросе!
Пример на PHP:
$url = 'https://agent.kbm-pro.ru/API/'; $post_data = array( 'API' => 'ASD!J@U#$^SHA!JAHA', 'OrderID' => '3746' ); $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data); $output = curl_exec($ch); curl_close($ch); echo $output;
На выходе Вы получите данные в формате JSON.
При успешном запросе в массиве ответа JSON Вы получите два значения:
- ‘success’ со значением ‘yes’,
- ‘OrderID’ — номер заявки,
- ‘OldKBM’ — старый КБМ (при наличии),
- ‘NewKBM’ — новый КБМ (при наличии),
- ‘ChangeDate’ — дата последней работы с заявкой (в формате дд.мм.гггг чч:мм),
- ‘Status’ — статус заявки (0 — принято, 1 — в работе, 2 — выполнен, 3 — отказ)
Например, {«success»:»yes»,»OrderID»:3747,»OldKBM»:0.55,»NewKBM»:NULL,»ChangeDate»:»21.10.2018 13:52″,»Status»:1}
При ошибке в запросе в массиве ответа JSON Вы получите одно значение:
- ‘error’ с кодом ошибки и её кратким описанием
Например, {«error»:»Code 09. No requested order»}