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

Author Автор: Роман Чернышов    Опубликовано: 11 марта 2021

INSSMART интеграция по API Доброго времени друзья! Сегодня я хочу рассказать о сервисе 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 данного сервиса можно завязать целую платформу — сайт, для страховых агентов и не только.

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

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

Заключение

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

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

  • Андрей 05.01.2023 в 10:36 дп

    А как получить токен для обращения к api?

    • Роман Чернышов 20.02.2023 в 3:19 пп

      Запросить в копании INSSMART

Оставить комментарий

Автор блога
Роман Чернышов
Веб-разработчик,
Full Stack
Senior, Architect
PHP, JavaScript, Node.JS, Python, HTML 5, CSS 3, MySQL, Bash, Linux Admin
Заказать работу
предложить оффер

Моя книга
Книга. Веб-разработчик. Легкий вход в профессию
Печатная книга
Веб-разработчик.
Легкий вход в профессию
Оформить предзаказ
Последние вопросы
Список вопросов
Последние комментарии
Меню

Archive

Мои проекты
Insurance CMS Love Crm CMS Совместные покупки Мой PHP Framework Хостинг для моих клиентов Лицензии на мой софт и поддержка