Страхование — API для партнеров
API позволяет интегрироваться с тематическим блоком, чтобы пользователи заполняли заявки на покупку полиса ОСАГО.
Благодаря интеграции пользователи смогут пройти меньше шагов от запроса до оформления полиса ОСАГО, а организации-партнеры могут увеличить возможный охват по релевантной аудитории.
Для интеграции необходимо реализовать публичный API эндпоинт.
Как настроить
Для подключения в качестве партнера:
-
Свяжитесь со службой поддержки по адресу finance-search@yandex-team.ru. В заголовке письма напишите: «Интеграция API в страховании <Название организации>».
-
Дождитесь, когда менеджер свяжется с вами по контактам, которые вы указали в письме.
-
Чтобы предоставить необходимую информацию, реализуйте публичный API эндпоинт. К нему Яндекс будет отправлять запросы. Вам нужно будет предоставлять офферы в ответ.
-
Пройдите проверку работоспособности интеграции.
Обзор ресурсов
Конечная интеграция со страховой компанией / агрегатором страховых услуг осуществляется через REST API.
Методы, предоставляющие справочники транспортных средств
Вызываются автоматически по планировщику для обновления справочников. Все ID справочников должны быть уникальными и не должны меняться в ходе обновления справочников на стороне партнера.
В случае изменения справочников на стороне партнера, необходимо предупредить команду Яндекса для оперативного обновления справочников.
Если партнер — агрегатор, нужно убедиться, что у вас единый справочник транспортных средств.
- Получение списка брендов.
- Получение списка моделей.
- Получение списка годов выпуска.
- Получение списка мощностей двигателя.
- Получение списка модификаций (необязательный).
- Получение иерархии автомобильных данных (необязательный).
- Получение информации об автомобиле
Методы для интеграции с блоком ОСАГО
- Создание запроса на расчет ОСАГО.
- Получение расчета ОСАГО.
- Получение статуса расчета ОСАГО (необязательный).
- Получение предложения ОСАГО (необязательный).
- Подтверждение предложения ОСАГО.
- Запрос на получение pdf-файла с черновиком полиса.
- Запрос на получение полиса.
- Подтверждение продажи.
Схема взаимодействия через API
После подтверждения действия пользователя, например на расчет полиса ОСАГО, направляется HTTP/REST запрос на сервис интеграции, реализованный на стороне партнера для получения информации о предложениях.

Остались вопросы?
Внимание
Специалисты отдела клиентского сервиса могут вас проконсультировать только по кампаниям того логина, с которого вы обращаетесь. Логин можно увидеть, если открыть ya.ru на соседней вкладке браузера. Специалист получит доступ к вашим данным только при обработке обращения.
Сканируйте QR-код или нажмите на него для перехода по ссылке.
При выборе Telegram, WhatsApp учитывайте, что Яндекс не контролирует, как сторонние мессенджеры хранят ваши данные и переписку на своей стороне, и не несет за это ответственность.