Интеграция по API с страховым маркетплейсом INSSMART

Автор: Роман Чернышов   

Доброго времени друзья! Сегодня я хочу рассказать о сервисе INSSMART который позиционирует себя как маркетплейс электронного страхования, то есть воспользовавшись им, любой желающий может оформить страховку будь то Е-ОСАГО, КАСКО, Ипотека или Животные. Зарегистрировавшись на сайте INSSMART вы можете стать страховым агентом, проводя все сделки через него, в свою очередь INSSMART сотрудничает с несколькими десятками страховых компаний, что позволяет, при оформлении полиса, выбрать наилучшее предложение, как по стоимости самого полиса, так и по комиссионному вознаграждению(которые вы получите). Маркеплейс имеет также API для взаимодействия с ним техническими средствами, например для подключения к нему вашего проекта, если вы работаете в области страхования. Ранее я уже рассказывал про аналогичные решения от Ингуру, Сравни и Пампаду. Сегодня я хочу рассмотреть API для Е-ОСАГО, его техническую сторону, возможности, методы и примеры работы. Далее обо всем по порядку.

Возможности

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

Данный сервис отличается от своих конкурентов тем, что предоставляет возможности несколько шире, в частности по API вы можете запрашивать КБМ водителей, данные диагностической карты, а также возможность выбора периода и целей страхования(и все это в рамках API), что несомненно позволяет существенно расширить функционал вашего проекта.

Описание API

INSSMART  предоставляет возможность подключения к API по средствам REST запросов. Все запросы к серверу API отправляются методами GET или POST, в формате JSON с передачей соответствующих заголовков. Заголовки запросов должны содержать токен авторизации Bearer, для доступа к методам API(кроме метода авторизации). Документация описывающая методы предоставляется по запросу в виде документа Word с описанием всего перечня методов, по конкретному продукту(Е-ОСАГО, КАСКО и т.д.). API позволяет осуществлять предварительный расчет, оформление, получение предложений, покупку и скачивание полиса ОСАГО.

Для того чтобы оформить полис, необходимо пройти три этапа:

• 1. Предварительный расчет стоимости, с минимальным количеством передаваемых данных;
• 2. Передача полного списка всех необходимых данных, с им последующей проверкой, а также проверкой готовности страховых компаний оформить полис;
• 3. Оформление полиса, переход на оплату. Для некоторых страховых компаний требуется проверка номера телефона по СМС.

Методы для взаимодействия с API

Ниже приведу описание некоторых методов, которые понадобятся для осуществления интеграции калькулятора ОСАГО(готовое решение, также является моей разработкой) с INSSMART для расчета стоимости полисов, оформления и их оплаты.

GET /main/contractCompanies — Справочник по страховым компаниям
GET /main/regions — Справочник по регионам
POST /product-osago/contracts/estimate — Предварительный расчет полиса osago
POST /product-osago/contracts — Создание, изменение, получение полиса osago
POST /product-osago/contracts/{id}/offers — Запуск и проверка статуса получения предложений
GET /product-osago/contracts/{id}/offers — Запрос на получение статуса поиска предложений
POST /product-osago/contracts/{id}/payments — Покупка, подтверждение оплаты и получение ссылки
GET /product-osago/contracts/{id}/docs — Получение документов на скачивание
POST /product-osago/KBMInfo — Получение кбм
GET /product-osago/technicalInspection — Получение данных диагностической карты
GET /product-osago/periods — Справочник периодов страхования
GET /product-osago/purposes — Справочник целей страхования
GET /dictionary/carMarks — Справочник марок автомобилей
GET /dictionary/carModels — Справочник моделей автомобилей

Пример работы с API

Пример запроса CURL:

curl -X GET \
 --url /v1/dictionary/carMarks?title=лад \
 --header 'cache-control: no-cache' \
 --header 'content-type: application/json' \
 --header 'Authorization: Bearer eyJnb...'

Пример запроса на PHP:

function connect($url, $post = null, $headers = array(), $ref = null, $cookie = 'cookie.txt') {
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
	curl_setopt($ch, CURLOPT_TIMEOUT, 0);
	curl_setopt($ch, CURLOPT_HEADER, 0);
	curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 0);
	curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 6.1; rv:22.0) Gecko/20100101 Firefox/22.0');  
	if(count($headers) > 0) curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	if($ref !== null) curl_setopt($c, CURLOPT_REFERER, $ref);
	if($cookie !== null) {
		curl_setopt($ch, CURLOPT_COOKIEFILE, $cookie);
		curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie);
	}
	if($post !== null) {
		curl_setopt($ch, CURLOPT_POST, 1);
		curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
	}
	$response =curl_exec($ch);
	curl_close($ch);
	return $response;
}
 
$response = connect('/v1/dictionary/carMarks?title=лад', null, array('Accept: application/json', 'Content-Type: application/json', 'Authorization: Bearer eyJnb...'));
 
var_dump($response);

Пример успешного ответа JSON:

{
   "total": 1,
   "startAt": 0,
   "maxResults": 150,
   "items": [
        {
           "id": "lada",
           "title": "ВАЗ/LADA",
           "companies": [0, 12, 9, 4, 3, 7, 8, 15, 13, 14, 2, 1, 11]
        }
    ]
}

Интеграция с вашим проектом

Благодаря столь широкому набору методов API, на базе интеграции с данным сервисом можно простоит любой проект, реализовав свои любые, уникальные идеи. Калькулятор стоимости ОСАГО с последующим оформлением, сервис проверки КБС, функционал для работы со справочниками: городами, регионами, марками и моделями авто. Если учесть сколько направлений страхования (Е-ОСАГО, КАСКО, Ипотека, Недвижимость, Животные, Короновирус) предоставляет INSSMART, то в совокупности на API данного сервиса можно завязать целую платформу — сайт, для страховых агентов и не только.

Заказ работы, интеграции

Если у вас есть потребность в интеграции с данным сервисом, обращайтесь — всегда рад помочь!

Заключение

Интеграция с подобным маркетплейсом дает множество преимуществ, но не стоит забывать и про недостатки, возможно в ряде проектов, все таки прямая интеграция со страховыми компаниями будет для вас куда более целесообразной и выгодной, прямая интеграция это: выше вероятность одобрения заявки, выше вознаграждение. Ведь работа с маркетплейсом, это работа со страховыми компаниями через посредника. С другой стороны, как я выше уже сказал — одна интеграция, дает возможность работать со всеми страховыми компаниями. Выбор остается за вами.

JavaScript / jQuery, PHP, Бизнес, Система     api, интеграция, интеграция страховые компании