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

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

Евакуатори, СТО, шиномонтаж, аварійні комісари, таксі — отримуйте заявки водіїв з INSUREX прямо у свою CRM чи диспетчерську й змінюйте статуси з неї. Усе, що є в кабінеті partner.izipolis.com, доступно й через API.

Базова адреса: https://izipolis.com/api/services. Авторизація: Authorization: Bearer <токен>. Методи працюють лише з токеном кабінету партнера — ключі страховиків чи агентів тут не підходять. Довідник методів →

Швидкий старт

  1. Зареєструйтеся на partner.izipolis.com, заповніть профіль, точку на мапі й послуги. Після перевірки платформою клієнти бачать вас у застосунку.
  2. Створіть окремого користувача-«робота» для інтеграції: Команда → «Додати», роль «Працівник».
  3. Отримайте токен і зберігайте його на сервері:
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Автоюрист