API для партнерів послуг
Евакуатори, СТО, шиномонтаж, аварійні комісари, таксі — отримуйте заявки водіїв з INSUREX прямо у свою CRM чи диспетчерську й змінюйте статуси з неї. Усе, що є в кабінеті partner.izipolis.com, доступно й через API.
https://izipolis.com/api/services. Авторизація: Authorization: Bearer <токен>.
Методи працюють лише з токеном кабінету партнера — ключі страховиків чи агентів тут не підходять.
Довідник методів →Швидкий старт
- Зареєструйтеся на partner.izipolis.com, заповніть профіль, точку на мапі й послуги. Після перевірки платформою клієнти бачать вас у застосунку.
- Створіть окремого користувача-«робота» для інтеграції: Команда → «Додати», роль «Працівник».
- Отримайте токен і зберігайте його на сервері:
curl -X POST https://izipolis.com/api/services/login \
-H "Accept: application/json" -H "Content-Type: application/json" \
-d '{"email":"[email protected]","password":"…"}'
# → {"data":{"token":"12|AbC…","user":{…}}}
Токен діє, доки ви не вийдете (POST /logout) або не змінять пароль чи вимкнуть користувача.
Заявки
| Статус | Що означає | Дія партнера |
|---|---|---|
new | Нова заявка; контакти клієнта приховано | POST /requests/{uuid}/accept або /reject |
accepted | Прийнято — з’явились client_name і contact_phone; заявка оплачувана | /start, /complete, /not-provided |
in_progress | Виїхали / виконуємо | /complete, /not-provided |
completed | Виконано; клієнт може оцінити | — |
not_provided | Клієнт відмовився; менеджер перевіряє й знімає оплату | — |
expired, rejected, cancelled | Не відповіли вчасно / відмовились / скасував клієнт | — |
# нові заявки
curl https://izipolis.com/api/services/requests?filter=new -H "Authorization: Bearer $TOKEN" -H "Accept: application/json"
# прийняти (з коментарем для клієнта)
curl -X POST https://izipolis.com/api/services/requests/$UUID/accept -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" -d '{"note":"Будемо за 20 хв"}'
# не надано (причина обов’язкова)
curl -X POST https://izipolis.com/api/services/requests/$UUID/not-provided -H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" -d '{"reason":"Клієнт завів авто сам"}'
На відповідь за новою заявкою є кілька хвилин (поле response_deadline_at) — після цього заявку автоматично отримає інший партнер.
Вебхуки
Профіль → «Вебхук вашої CRM» (лише https://). Платформа надсилає POST з JSON:
{"event":"request.created","created_at":"2026-11-11T12:30:00+02:00","data":{"uuid":"…","status":"new","category":{"code":"tow","name":"Евакуатор"},"address":"…","lat":50.45,"lng":30.52, …}}
| Подія | Коли |
|---|---|
request.created | Нова заявка (зокрема передана від іншого партнера) |
request.cancelled | Клієнт скасував заявку |
auction.created | Новий запит страховика на калькуляцію у вашій зоні (для СТО) |
auction.won / auction.lost | Страховик обрав вашу / іншу пропозицію |
Підпис: заголовок X-Signature: sha256=<HMAC-SHA256(тіло, секрет)>, подія — у X-Event. Секрет показується в кабінеті під час генерації.
// PHP
$ok = hash_equals('sha256=' . hash_hmac('sha256', file_get_contents('php://input'), $secret), $_SERVER['HTTP_X_SIGNATURE'] ?? '');
Аукціони калькуляцій (СТО)
Увімкніть у профілі «Брати участь в аукціонах» і додайте послугу «СТО». GET /auctions — запити у вашій зоні; POST /auctions/{uuid}/bid — пропозиція
(total, days, необов’язково складові, гарантія, тип запчастин, файл калькуляції як multipart). Інші СТО ваших пропозицій не бачать.
Категорії послуг
| Код | Послуга | У SOS |
|---|---|---|
tow | Евакуатор | так |
commissioner | Аварійний комісар | так |
roadside | Технічна допомога | так |
tire_mobile | Виїзний шиномонтаж | так |
fuel | Доставка пального | так |
ev_charge | Мобільна зарядка електромобіля | так |
unlock | Відкриття авто | так |
sto | СТО | |
ev_service | СТО для електромобілів | |
tire | Шиномонтаж | |
taxi | Таксі | |
lawyer | Автоюрист |