API восстановления КБМ

Для работы на платформе через API вам необходимо зарегистрироваться или войти на платформу.

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

Восстановление КБМ

Для восстановления и понижения КБМ на платформе, вы можете использовать бесплатный API. Для этого Вам понадобится API ключ. Стоимость одной исполненной заявки на понижение КБМ через API составляет 120 рублей. Цена может оговариваться в зависимости от объемов. По всем вопросам вы можете обратиться по телефону: 8-966-110-90-95

Взаимодействие осуществляется с помощью post запросов. Пример класса на php:

Все запросы посылаются на адрес: https://uosago.ru/engine/uosago/request/kbm/api.php

Каждый запрос среди прочих параметров должен передавать API ключ.

class UOSAGO_APIKBM{
	public $url = 'https://uosago.ru/engine/uosago/request/kbm/api.php';
	public $api_key = 'Ваш API ключ';
	public $sprav_kbm = array(
		'new'=>'Заявка создана',
		'work'=>'В работе',
		'rsa'=>'На рассмотрении в РСА',
		'done'=>'Выполнена',
		'fail'=>'Заявка отклонена',
		'repeat'=>'Повтор',
		'error'=>'Ошибка',
		'deleted'=>'Удалена',
	);
	function makeRequest($post){
		$ch = curl_init();   
		$post['API'] = $this->api_key;
		curl_setopt($ch, CURLOPT_URL, $this->url); 
		curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);   
		curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");   
		curl_setopt($ch, CURLOPT_ENCODING, "utf-8");   
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $post); 
		$output = curl_exec($ch); 
		return $output;
	}
}
				

Метод create

Позволяет создать новую заявку на восстановление КБМ. Необходимо наличие денежных средств на аккаунте, API ключ, которого вы используете. Метод позволяет создавать заявки на восстановление КБМ при простой потере КБМ, при смене фамилии или имени, при смене прав и тд. Пример создания заявки с помощью метода на php с использованием класса выше.

$kbm = new UOSAGO_APIKBM();

$post['action'] = 'create';
$post['surname'] = 'Фамилия';
$post['name'] = 'Имя';
$post['mname'] = 'Отчество';
$post['birthday'] = '04.01.1994';
$post['license'] = '7716 421834';

$result = $kbm->makeRequest($post);			
			

В случае успешного создания заявки в массиве result вы получите:

• status - текущий статус заявки, все статусы смотри в классе UOSAGO_APIKBM выше.
• ID - уникальный идентификатор заявки в системе, он необходим в дальнейшем для проверки статуса заявки.

Пример ответа при успешном создании заявки:

{"result":{"status":"work","ID":"1761090","message":"\u0421\u0442\u0430\u0442\u0443\u0441 \u0437\u0430\u044f\u0432\u043a\u0438: \u0412 \u0440\u0430\u0431\u043e\u0442\u0435"}}

Статусы заявок:

$sprav_kbm = array(
 'new'=>'Заявка создана',
 'work'=>'В работе',
 'rsa'=>'На рассмотрении в РСА',
 'done'=>'Выполнена',
 'fail'=>'Заявка отклонена',
 'repeat'=>'Повтор',
 'error'=>'Ошибка',
 'deleted'=>'Удалена',
);

В случае ошибки вы получите массив ошибок errors. Например:

{"errors":["API \u043a\u043b\u044e\u0447 \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d"]}

Список полей, которые можно передавать при создании заявки:

$post = array(
	'surname'=>'Фамилия',			// Текущая фамилия водителя
	'name'=>'Имя',				// Текущее имя водителя
	'mname'=>'Отчество',			// Текущее отчество водителя
	'birthday'=>'01.01.1990',		// Дата рождения, формат: dd.mm.yyyy
	'license'=>'7856 586988',		// Серия и номер ВУ, формат : 9999 999999
	'passport'=>'4265 856963',		// Серия и номер паспорта, формат: 9999 999999
	'old_license'=>'4568 855669',		// Серия и номер предыдущего ВУ, формат : 9999 999999
	'old_passport'=>'Отчество',		// Серия и номер предыдущего паспорта, формат: 9999 999999
	'old_surname'=>'Отчество',		// Предыдущее отчество водителя
);

Метод status

Позволяет узнать статус ранее созданной заявки по ее ID. Пример использования метода вы можете видеть ниже:

$kbm = new UOSAGO_APIKBM();

$post['action'] = 'status';
$post['ID'] = '1589652';

$result = $kbm->makeRequest($post);

В результате выполнения заявки вы получите json ответ, который в полях массива esult содержит новый статус в поле status и ID заявки.

В случае ошибки вы получите массив ошибок errors.