Эта статья поможет разобраться, как использовать API МИС Renovatio на практике — с чего начать, какие методы использовать, как выстроить логику взаимодействия с внешними порталами или внутренними системами.
🧩 Поддерживаемые методы API
Основные методы, необходимые для интеграции с сервисами самозаписи:
- getClinics — получение списка клиник
- getProfessions — получение списка специальностей
- getUsers — получение списка сотрудников (врачей)
- getServiceCategories — категории услуг
- getServices — список медицинских услуг
- getScheduleCategories — категории расписания
- getSchedule — расписание врача
- createAppointment — создание записи на приём
- cancelAppointment — отмена записи
- confirmAppointment — подтверждение записи
Эти методы обязательны для подключения к популярным сервисам самозаписи: СберЗдоровье, ПроДокторов, НаПоправку и другим.
📘 Сценарий 1. Отображение слотов и запись на приём
Этот сценарий применим к внешним сайтам, мобильным приложениям и любым системам, где пациент может выбрать врача, дату и записаться.
Шаг 1. Получение справочников
Запосите справочные данные для отрисовки интерфейса выбора:
GET /getClinics GET /getProfessions GET /getUsers GET /getServiceCategories GET /getServices GET /getScheduleCategories
Используйте clinic_id, user_id, service_id в дальнейших методах
Шаг 2. Получение слотов
GET /getSchedule
Пример запроса:
{
"clinic_id": 1,
"user_id": 245,
"service_id": 102,
"date_from": "2025-05-20",
"date_to": "2025-05-25",
"use_doctor_avg_time": true
}
⚠️ use_doctor_avg_time позволяет учитывать реальное среднее время приёма, указанное в карточке врача. Это особенно важно, если приёмы не фиксированы по 30 минут.
Шаг 3. Создание записи
POST /createAppointment
Пример запроса:
{
"clinic_id": 1,
"user_id": 245,
"service_id": 102,
"date": "2025-05-21",
"time": "10:30",
"patient": {
"name": "Петров Петр",
"phone": "+79001234567",
"email": "petrov@example.com"
},
"source_id": 12,
"channel_id": 7
}
Шаг 4. Отмена и подтверждение
-
Отмена визита:
POST /cancelAppointment
-
Подтверждение визита:
POST /confirmAppointment
📘 Сценарий 2. Экспорт данных в 1С или внешнюю систему
Если вам нужно регулярно выгружать список визитов или расписание врачей, вы можете настроить экспорт с использованием API.
Пример шагов:
- Получить расписание или записи за определённый период:
GET /getSchedule
GET /getUsers
GET /getServices - Сформировать таблицу или JSON-файл на своей стороне
- Передать данные в 1С или другое ПО (например, через REST, файловый экспорт или брокер событий)
🔁 Разница между первой и второй версией API
| Характеристика | API v1 | API v2 |
|---|---|---|
| Формат | JSON | JSON |
| Разработка | Не развивается | Активно поддерживается |
| Структура | Простая | Расширенная, более гибкая |
| Поддержка use_doctor_avg_time | Нет | Да |
| Рекомендация | Устаревающие интеграции | Все новые подключения |
📌 Новые порталы (включая СберЗдоровье) работают только с API v2. Используйте его для всех новых проектов.
💡 Полезные замечания
- Все методы требуют наличия API-ключа, который создается в модуле Интеграции → API-ключи
- Для корректной работы самозаписи важно:
— Указывать длительность услуг в минутах
— Обновлять карточки врачей: филиалы, услуги, длительность приёма
— Убедиться, что у врача есть график работы, и он содержит свободные слоты
Более подробно в этой статье: Подключение интеграторов самозаписи
🟠 Если в ближайшие 7/14/30 дней нет свободных слотов в графике — портал их не покажет.