API для компаній
Перевізники, будівельні й торгові компанії, офіси: автопарк, документи з термінами, люди й чати INSUREX — у вашій 1С, ERP, HR-системі чи диспетчерській. ДТП, дефекти з передрейсових оглядів і тривоги телематики приходять вебхуком за секунди.
https://izipolis.com/api/corp/v1. Авторизація: Authorization: Bearer ck_… — веб-кабінет компанії
izipolis.com/company → «Інтеграції».
Довідник методів →Швидкий старт
- Увійдіть у веб-кабінет компанії як власник або адміністратор і відкрийте «Інтеграції».
- «Створити ключ»: назвіть його за системою («1С», «Диспетчерська») і позначте лише ті сервіси, які їй потрібні. Ключ показуємо один раз — збережіть його на сервері.
- Перевірте ключ:
GET /companyповерне компанію і доступи ключа. - За потреби вкажіть адресу вебхука й події — і отримуйте зміни без опитування.
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 хвилин. Протестувати без свого сервера — тимчасовий приймач у консолі.
Ліміти й журнал
- 240 запитів на хвилину, надсилання повідомлень — 120 на хвилину.
- До 10 активних ключів на компанію; відкликаний ключ перестає працювати миттєво.
- Останні виклики (метод, статус, тривалість) видно в «Інтеграціях», журнал зберігається 30 днів.