Программный интерфейс (API) к сервису исправления КБМ

Уважаемые партнеры, владельцы или разработчики web сайтов, наш центр обработки предоставляет программный интерфейс (API) для реализации сервиса исправления КБМ в РСА на своем сайте.

Как происходит обработка заявок коррекции КБМ через API:

1. На вашем сайте создаются заявки на исправление КБМ и передаются по программному интерфейсу обезличенными в наш центр обработки. При успешной передаче, на ваш сайт возвращается ответ: идентификатор заявки, значение КБМ на дату обработки заявки и ссылка на файл отчета РСА.

2. Ваш сайт эпизодически по api делает запрос в наш центр обработки по идентификаторам заявок, находящихся в работе. При этом могут возвращаться шесть вариантов ответов (статусы заявок): Выполнен, РСА, Отказ, Оператор, Ошибка, пусто (нет статуса). Если заявка имеет статус Выполнен, то дополнительно передается значение нового КБМ и ссылка на файл отчета РСА.  Полученный результат ваш сайт самостоятельно транслирует заказчику исправления КБМ.  Вместо сканирования статусов по каждой заявке, можно сразу получать и обрабатывать журнал заявок за период.  

Процесс прохождения заявок по статусам: Пусто - заявка в очереди на обработку. Раз в 10 минут заявки распределяются в очередь Операторам, соответственно меняется статус на Оператор, при этом записывается значение КБМ был и прикрепляется ссылка на файл отчета РСА по КБМ был. Раз в 30 минут, заявки со статусом Оператор меняют статус на РСА - что означает в работе. Далее заявка в процессе обработки примет один из двух статусов - Выполнен или Отказ.  Статус Ошибка присваивается нами вручную, при явном обнаружении ошибки в заявке до момента, пока она еще не имеет статус РСА.  Заявки, имеющие статус РСА - корректироваться или отменяться не могут.

Также доступен API проверки КБМ. Инструкция находится по адресу http://api.kbm-pro.ru/readme.html (для получения доступа свяжитесь с нами по адресу support@kbm-pro.ru или WhatsApp: +7-902-845-96-01 или Telegram: KBM_pro)

 

Подробное описание API передачи заявок:

Вы можете самостоятельно реализовать интерфейсную часть КБМ сервиса и подключить его к нашему api. Необходимые примеры и консультацию вашим специалистам предоставим. Как это сделать:

- запросить kbmkey и попросить установить вам тестовый режим.  Сможете создать программно создавать заявки и получать их состояния. Важное замечание - тестовые заявки не обрабатываются, а только отражаются в интерфейсе нашей программы, они для первоначальной отладки вашей программы, чтобы ознакомиться со структурой ответов и проверить корректность передаваемых данных. 

- после того, как отладите работу своего сайта в тестовом режиме, вы заключите с нами договор на реальную обработку ваших заявок и запрашиваете отмену тестового режима для своего kbmkey. 

Ниже описание  функционала программного интерфейса исправления КБМ.

kbmkey передается в url get-запроса, для тестовой зоны &kbmkey=kbmtest
Пример создания заявки исправления КБМ водителя
$data=array();
$data["fam"]="Иванов"; //фамилия
$data["im"]="Сергей"; //Имя
$data["otch"]="Алексеевич"; //Отчество (если есть)
$data["birthday"]="30.10.1985"; //Дата рождения
$data["vod"]="22УМ 999333"; //Серия и номер ВУ. Серия может быть короче 4 знаков, например для Абхазии 2 знака, но пробел между серией и номером обязателен.
$data["pasp"]="6002 200300"; //Необязательно, серия и номер паспорта.
$data["old_fam"]=""; //Необязательно, прошлая фамилия, если была смена.
$data["old_vod"]="6001 000111"; //Необязательно, серия и номер предыдущего ВУ. Рекомендуем по возможности заполнять, влияет на качество и скорость обработки.
$data["old_pasp"]=""; //Необязательно, серия и номер прошлого паспорта, если была смена фамилии
$data["datekbm"]="25.12.2018"; //Дата расчета "КБМ был" (до изменения нашим сервисом), равен текущей дате или в диапазоне до +60 дней от текущей.
$data=urlencode(json_encode($data));
$url="https://agent.kbm-pro.ru/apikbm.php?new&kbmkey=kbmtest&data=".$data;
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В возвращаемом массиве $result содержится id созданной заявки, old_kbm - числовое значение "КБМ был", download - ссылка на файл РСА кбм был

Пример получения статуса заявки по id
$url="https://agent.kbm-pro.ru/apikbm.php?kbmkey=kbmtest&id=22583";
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В возвращаемом массиве $result содержится old_kbm - числовое значение "КБМ был", new_kbm - "КБМ стал (после обрабоки)", f_old - ссылка на файл отчета РСА КБМ был, f_new - ссылка на файл отчета РСА КБМ стал, status - возможные значения: "Выполнен" - кбм успешно понижен, "Отказ" - кбм не понижен, "РСА" - находится в обработке, "(пусто)" или "Оператор" - в очереди на обработку (интервал до 30 мин)

Пример получения списка (журнала) своих заявок в интервале от 0 до 14 дней назад с текущего момента, 0 - выборка за текущий день.
$url="https://agent.kbm-pro.ru/apikbm.php?kbmkey=kbmtest&jr=2"; //в данном примере jr=2 - глубина 2 дня.
$result = file_get_contents($url);
print_r(json_decode(urldecode($result)));

В каждой строке возвращаемого массива $result содержится массив с ключами id, created, fam, im, otch, birthday, vod, pasp, old_fam, old_vod, old_pasp, avto, KBM_avto, old_kbm, f_old, status, new_kbm, f_new, datekbm".
Внимание! Файлы отчетов РСА в ключах f_old и f_new хранятся на нашей стороне 30 дней.