Центр розробника IZI Polis
Усі способи інтегруватися з платформою в одному місці. Оберіть, хто ви, — і отримаєте документацію, довідник методів і тестове середовище саме для вашої ролі.
Страховикам
Заяви клієнтів про страхові події з фото, чати щодо полісів, фото-огляди авто й житла, аукціон калькуляцій ремонту для СТО.
- Partner API + вебхуки з підписом
- Тестовий ключ і консоль без коду
- Тимчасовий приймач вебхуків
Партнерам послуг
Евакуатори, СТО, шиномонтаж, аварійні комісари, таксі: заявки водіїв з INSUREX у вашу CRM чи диспетчерську, аукціони калькуляцій.
- API кабінету партнера
- Вебхуки про нові заявки
- Прийняти → в роботі → виконано
Клінікам
Пацієнти записуються з INSUREX, ви підтверджуєте час у кабінеті чи з вашої МІС — пацієнт отримує пуш і нагадування.
- Записи: підтвердити, перенести, запропонувати інший час
- Лікарі й послуги з цінами з МІС
- Вебхуки про нові записи
Компаніям
Автопарк, документи, люди й чати компанії — у вашій 1С, ERP, HR-системі чи диспетчерській. Події про ДТП, огляди й телематику — вебхуком.
- Ключі з доступами, як у групах
- Синхронізація авто й документів
- Журнал викликів у кабінеті
Агентам і посередникам
Власний сайт, CRM чи бот: розрахунок і оформлення полісів у всіх підключених страховиків, договори, клієнти, оплата.
- API агента (токен інтеграції)
- Права read / write, обмеження за IP
- Зовнішній інтернет-магазин
Доступ і ключі
Документація відкрита для всіх, а методи — лише з ключем потрібного типу. Ключ одного API в іншому не працює: страховик не викличе методи партнера послуг, партнер — методи агента.
| Хто | Адреса API | Ключ | Де отримати |
|---|---|---|---|
| Страховик | https://izipolis.com/api/partner/v1 | ipk_… бойовий, ipk_test_… тестовий | Менеджер IZI Polis видає ключі; тестовий — одразу після підключення |
| Партнер послуг | https://izipolis.com/api/services | Bearer-токен | Реєстрація на partner.izipolis.com, далі POST /login |
| Клініка | https://izipolis.com/api/services/clinic | Ключ інтеграції | Реєстрація клініки на partner.izipolis.com → «Інтеграція» |
| Компанія | https://izipolis.com/api/corp/v1 | ck_… з доступами | Веб-кабінет компанії → «Інтеграції» (власник чи адміністратор) |
| Агент / посередник | https://izipolis.com/api/agent | Токен інтеграції з правами | Кабінет агента → «API» (до 10 токенів, IP-обмеження) |
Довідник методів
Інтерактивний довідник OpenAPI для кожного API: параметри, приклади відповідей і виконання запитів просто в браузері.
Відкрити довідникСпецифікації OpenAPI
Для генерації клієнтів (openapi-generator, Postman, Insomnia):
Загальні правила
- HTTPS і JSON. Дати — ISO 8601 з часовим поясом, суми — у гривнях.
- Помилки:
401— невірний ключ,403— немає прав,404— не знайдено (або належить іншому ключу),422— валідація з полемerrors,429— ліміт запитів. - Вебхуки підписуються HMAC-SHA256 секретом вашого вебхука; перевіряйте підпис і відповідайте
2xxза кілька секунд. - Персональні дані клієнтів обробляйте лише для виконання послуги; не зберігайте більше, ніж потрібно.