API для агентів і посередників
Оформлюйте поліси всіх підключених страховиків зі свого сайту, CRM, чат-бота чи інтернет-магазину: розрахунок, резервування, підписання клієнтом, оплата, активація, договори й клієнти.
Базова адреса:
https://izipolis.com/api/agent. Авторизація: Authorization: Bearer <токен інтеграції>.
Токен діє від імені агента, який його створив, у межах його проєктів. Довідник методів →Як отримати доступ
- Станьте агентом партнера платформи (або партнером — тоді запросіть себе агентом свого проєкту).
- Кабінет агента → «API» → «Створити токен». Оберіть права й, за потреби, дозволені IP-адреси.
- Токен показується один раз — збережіть його на сервері. До 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} # активація після оплати
Повний перелік методів, параметрів і прикладів — у довіднику (специфікація генерується з коду й завжди актуальна).