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

API для клінік

Медичні центри, стоматології, лабораторії: пацієнти записуються з застосунку INSUREX, а ви підтверджуєте час у кабінеті partner.izipolis.com або прямо з вашої МІС. Пацієнт отримує пуш із точним часом і нагадування за добу.

Базова адреса: https://izipolis.com/api/services. Авторизація: Authorization: Bearer <ключ інтеграції> — кабінет клініки → «Інтеграція». Довідник методів →

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

  1. Зареєструйтеся на partner.izipolis.com як клініка, заповніть профіль і точку на мапі. Після перевірки ви з’явитесь у пошуку застосунку й у довіднику медзакладів.
  2. Передайте лікарів і послуги з цінами — вручну в кабінеті або одним запитом PUT /clinic/catalog.
  3. Кабінет → «Інтеграція» → «Створити ключ». Збережіть його на сервері МІС.
  4. Вкажіть вебхук (Профіль → вебхук) — нові записи прийдуть миттєво. Або опитуйте 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 — страховик бачить це у своїй системі автоматично, а пацієнт отримує сповіщення. Окремих інтеграцій із кожним страховиком не потрібно. Оплата платформі за такі записи не нараховується.

Оплата

Платформа виставляє рахунок раз на місяць за записи, які ви підтвердили. Запис, скасований пацієнтом, не оплачується; «пацієнт не прийшов» перевіряє менеджер. Рахунки — у кабінеті, розділ «Рахунки».