API для клінік
Медичні центри, стоматології, лабораторії: пацієнти записуються з застосунку INSUREX, а ви підтверджуєте час у кабінеті partner.izipolis.com або прямо з вашої МІС. Пацієнт отримує пуш із точним часом і нагадування за добу.
https://izipolis.com/api/services. Авторизація: Authorization: Bearer <ключ інтеграції> — кабінет клініки → «Інтеграція».
Довідник методів →Швидкий старт
- Зареєструйтеся на partner.izipolis.com як клініка, заповніть профіль і точку на мапі. Після перевірки ви з’явитесь у пошуку застосунку й у довіднику медзакладів.
- Передайте лікарів і послуги з цінами — вручну в кабінеті або одним запитом
PUT /clinic/catalog. - Кабінет → «Інтеграція» → «Створити ключ». Збережіть його на сервері МІС.
- Вкажіть вебхук (Профіль → вебхук) — нові записи прийдуть миттєво. Або опитуйте
GET /clinic/bookings?filter=newраз на хвилину.
Як проходить запис
| Статус | Що означає | Ваша дія |
|---|---|---|
pending | Пацієнт надіслав заявку: лікар чи послуга, зручний час, скарги | confirm з точним часом, propose інший час або reject |
proposed | Ви запропонували інший час — чекаємо пацієнта | — |
confirmed | Час підтверджено; пацієнт отримав пуш, за добу — нагадування. Запис оплачуваний | Перенести — повторний confirm; після прийому — visited або no-show |
visited | Прийом відбувся, пацієнт може оцінити клініку | — |
no_show | Пацієнт не прийшов — менеджер платформи перевіряє й знімає оплату | — |
cancelled | Скасовано пацієнтом (без оплати) або вами | — |
# нові заявки
curl "https://izipolis.com/api/services/clinic/bookings?filter=new" -H "Authorization: Bearer $KEY" -H "Accept: application/json"
# підтвердити точний час
curl -X POST https://izipolis.com/api/services/clinic/bookings/$UUID/confirm -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"slot_at":"2026-11-13T17:30:00+02:00","doctor_id":12,"slot_note":"Кабінет 12, 2 поверх"}'
# запропонувати інший час
curl -X POST https://izipolis.com/api/services/clinic/bookings/$UUID/propose -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"slot_at":"2026-11-13T18:30:00+02:00","message":"На 17:00 зайнято, є 18:30"}'
Каталог із МІС
curl -X PUT https://izipolis.com/api/services/clinic/catalog -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{
"doctors":[{"external_id":"D-17","name":"Іваненко Олена","specialty":"pediatrician","price":700,"schedule_note":"Пн, Ср, Пт 9–15"}],
"services":[{"external_id":"S-3","name":"УЗД черевної порожнини","category":"diagnostics","price":900,"duration_min":30}],
"prune":true
}'
Без МІС — файлом: кабінет → «Лікарі» чи «Послуги й ціни» → «Завантажити з файлу». Шаблони: лікарі (XLSX), послуги й ціни (XLSX), список закладів мережі (XLSX) — для імпорту в довідник платформи (надішліть менеджеру).
Спеціалізації: therapist — Терапевт / сімейний лікар, pediatrician — Педіатр, gynecologist — Гінеколог, dentist — Стоматолог, cardiologist — Кардіолог, neurologist — Невролог, ent — ЛОР, ophthalmologist — Офтальмолог, dermatologist — Дерматолог, surgeon — Хірург, traumatologist — Травматолог, urologist — Уролог, endocrinologist — Ендокринолог, gastroenterologist — Гастроентеролог, diagnostics — Діагностика (УЗД, МРТ, рентген), lab_tests — Аналізи, vaccination — Вакцинація, massage — Масаж і фізіотерапія .
Вебхуки
| Подія | Коли |
|---|---|
clinic.booking.created | Нова заявка пацієнта |
clinic.booking.confirmed | Пацієнт погодився на запропонований вами час |
clinic.booking.cancelled | Пацієнт або страховик скасував запис |
clinic.booking.updated | Страховик змінив час, лікаря чи гарантійний лист у записі за ДМС |
{"event":"clinic.booking.created","created_at":"2026-11-11T12:30:00+02:00","data":{"booking":{"uuid":"…","status":"pending","doctor":{"id":12,"name":"Іваненко Олена"},"patient":{"name":"Марія Коваль","birth_date":"2019-04-01","phone":"+380671234567"},"preferred":"Завтра; Після 16:00", …}}}
Підпис: X-Signature: sha256=<HMAC-SHA256(тіло, секрет)>. Секрет — у кабінеті, Профіль → «Новий секрет».
Записи за ДМС від страховиків
Страховики, які працюють через платформу, записують застрахованих у вашу клініку напряму: запис приходить уже підтвердженим, з payer: "insurer",
номером гарантійного листа й карткою ДМС (dms). Переносите прийом (confirm з новим часом) чи відмічаєте visited / no-show —
страховик бачить це у своїй системі автоматично, а пацієнт отримує сповіщення. Окремих інтеграцій із кожним страховиком не потрібно. Оплата платформі за такі записи не нараховується.
Оплата
Платформа виставляє рахунок раз на місяць за записи, які ви підтвердили. Запис, скасований пацієнтом, не оплачується; «пацієнт не прийшов» перевіряє менеджер. Рахунки — у кабінеті, розділ «Рахунки».