Перейти до вмісту

API для агентів і посередників

Оформлюйте поліси всіх підключених страховиків зі свого сайту, CRM, чат-бота чи інтернет-магазину: розрахунок, резервування, підписання клієнтом, оплата, активація, договори й клієнти.

Базова адреса: https://izipolis.com/api/agent. Авторизація: Authorization: Bearer <токен інтеграції>. Токен діє від імені агента, який його створив, у межах його проєктів. Довідник методів →

Як отримати доступ

  1. Станьте агентом партнера платформи (або партнером — тоді запросіть себе агентом свого проєкту).
  2. Кабінет агента → «API» → «Створити токен». Оберіть права й, за потреби, дозволені IP-адреси.
  3. Токен показується один раз — збережіть його на сервері. До 10 токенів на агента; будь-який можна відкликати.

Права токена

ПравоЩо даєМетодів
readПродукти, довідники, тарифи, розрахунок, перегляд договорів і клієнтів17
writeРезервування, підписання, активація, посилання на оплату, SMS клієнту8
shopЗовнішній інтернет-магазин агента: релізи, теми, контент, оформлення за фото документів10

Токени інтеграції бачать лише методи з цього переліку — налаштування безпеки, команда й самі токени через API недоступні. Ліміт — 120 запитів на хвилину на токен (429 і Retry-After при перевищенні).

Типовий сценарій оформлення

GET  /products                               # доступні продукти
POST /conclude/getProductFields              # які поля заповнити
POST /conclude/getTariffs                    # страховики й тарифи
POST /conclude/calculate                     # розрахунок → order_id
POST /conclude/reserve                       # резерв з даними клієнта й об’єкта
POST /agreements/sign/law/{order_id}         # OTP з SMS клієнта
POST /agreements/sign/agreement/{order_id}
GET  /payments/link/{order_id}               # посилання на оплату
GET  /agreements/activate/{order_id}         # активація після оплати

Повний перелік методів, параметрів і прикладів — у довіднику (специфікація генерується з коду й завжди актуальна).