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

API для компаній

Перевізники, будівельні й торгові компанії, офіси: автопарк, документи з термінами, люди й чати INSUREX — у вашій 1С, ERP, HR-системі чи диспетчерській. ДТП, дефекти з передрейсових оглядів і тривоги телематики приходять вебхуком за секунди.

Базова адреса: https://izipolis.com/api/corp/v1. Авторизація: Authorization: Bearer ck_… — веб-кабінет компанії izipolis.com/company → «Інтеграції». Довідник методів →

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

  1. Увійдіть у веб-кабінет компанії як власник або адміністратор і відкрийте «Інтеграції».
  2. «Створити ключ»: назвіть його за системою («1С», «Диспетчерська») і позначте лише ті сервіси, які їй потрібні. Ключ показуємо один раз — збережіть його на сервері.
  3. Перевірте ключ: GET /company поверне компанію і доступи ключа.
  4. За потреби вкажіть адресу вебхука й події — і отримуйте зміни без опитування.
curl https://izipolis.com/api/corp/v1/company -H "Authorization: Bearer $KEY" -H "Accept: application/json"

Доступи ключа

Доступи ключа — ті самі сервіси й рівні, що й у «Сервісах для груп» кабінету. Метод без доступу відповідає 403 з поясненням, що саме розширити. Особисті чати працівників і медичні подробиці ДМС через API недоступні за будь-яких доступів.

СервісРівніЩо відкриває в API
ЧатиБачить/chats, повідомлення, групові чати
АвтопаркБачить, ВноситьБачить: GET /vehicles, події й огляди. Вносить: додати чи оновити авто, пробіг
Документи й терміниБачить, ВноситьБачить: GET /documents. Вносить: додати й змінити документ
Договори страхуванняБачитьGET /policies
ТелематикаБачить/telematics/positions, /telematics/events
Огляди перед рейсомБачитьGET /pretrip
Події: ДТП, поломкиБачить, КеруєGET /incidents
МедицинаБачить, Вносить, Керує/dms, /dms/employees, /accident (НВ)
ВідрядженняБачитьGET /trips
АналітикаБачить—
УчасникиКеруєКонтакти в GET /members, POST /members — запросити працівника

Синхронізація автопарку й документів

POST /vehicles працює як «додати або оновити»: якщо авто з таким номером уже є, ми оновимо його і відповімо 200, нове — 201. Тож нічну вигрузку з облікової системи можна відправляти як є, без зберігання наших ідентифікаторів.

curl -X POST https://izipolis.com/api/corp/v1/vehicles -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"plate":"AA1234BB","name":"Renault Master","year":2021,"mileage":125400}'

# документ із терміном дії та файлом
curl -X POST https://izipolis.com/api/corp/v1/documents -H "Authorization: Bearer $KEY" \
  -F "type=inspection" -F "subject_type=vehicle" -F "vehicle=$VEHICLE_UUID" \
  -F "number=ТК-118/26" -F "valid_until=2027-05-31" -F "file=@техконтроль.pdf"

Коди типів документів — GET /document-types. Перед кінцем терміну відповідальні отримують нагадування в застосунку — за стільки днів, скільки налаштовано для типу документа.

Чати для диспетчерської

Бот чи CRM пише в групові чати й оголошення від свого імені (author_name). external_id захищає від дублів при повторі запиту.

curl -X POST https://izipolis.com/api/corp/v1/chats/$CHAT_UUID/messages -H "Authorization: Bearer $KEY" \
  -F "body=Авто AA1234BB повернулося на склад" -F "author_name=Диспетчер" -F "external_id=trip-5512" -F "files[]=@акт.pdf"

Вебхуки

ПодіяКоли
corp.chat.message.createdНове повідомлення в чаті компанії (крім особистих)
corp.incident.createdНова подія з авто: ДТП, поломка, евакуація
corp.pretrip.defectДефект в огляді перед рейсом
corp.trip.requestedВідрядження на погодження
corp.telematics.eventКритична подія телематики: удар, тривожна кнопка
corp.document.createdНовий документ чи термін
corp.accident.reportedПрацівник повідомив про нещасний випадок (без медичних подробиць)
pingПеревірка вебхука
{"event_id":"…","type":"corp.pretrip.defect","company":{"uuid":"…","edrpou":"12345678"},"occurred_at":"2026-11-17T07:42:10+02:00",
 "data":{"check":{"uuid":"…","date":"2026-11-17","vehicle":{"uuid":"…","plate":"AA1234BB","name":"Renault Master"},"defects":"Тиск у шинах","mileage":125400}}}

Підпис: X-Signature: sha256=HMAC_SHA256("{X-Timestamp}.{тіло}", секрет) — секрет показуємо один раз при збереженні адреси. Відповідайте 2xx за 10 секунд, інакше повторимо через 1, 5 і 30 хвилин. Протестувати без свого сервера — тимчасовий приймач у консолі.

Ліміти й журнал