Что синхронизировать с Avtomatizaciya-Kliniki

Для построения экосистемы медицинской организации критически важно обеспечить двусторонний обмен данными между МИС и внешними сервисами. Ниже приведены основные сущности для синхронизации:

• Пациенты (Patient): Синхронизация с CRM (Bitrix24/amoCRM) и сервисами рассылок. API-метод: POST /api/v1/patients/create.
• Записи на прием (Appointments): Двусторонняя интеграция с сервисами онлайн-записи (Yclients, ProDoctorov). API-метод: GET /api/v1/appointments/list.
• Прайс-лист и услуги (Services): Выгрузка в мобильные приложения и на сайты. API-метод: GET /api/v1/catalog/services.
• Результаты анализов (LabResults): Передача данных в личный кабинет пациента. API-метод: POST /api/v1/lab/results/upload.
• Счета и транзакции (Invoices): Передача данных в 1С:Бухгалтерия для учета выручки. API-метод: GET /api/v1/finance/invoices.
• Сотрудники и графики (Staff): Синхронизация расписания врачей с HR-системами. API-метод: GET /api/v1/staff/schedule.
• Медицинские карты (EHR): Интеграция с ЕГИСЗ (требует защищенного канала). API-метод: POST /api/v1/ehr/sync.

Технические особенности API Avtomatizaciya-Kliniki

• Аутентификация: Использование Bearer-токенов. Токен передается в заголовке Authorization: Bearer {token}, срок жизни токена — 24 часа.
• Формат данных: Все запросы и ответы строго в формате application/json. Кодировка — UTF-8.
• Rate Limits: Ограничение составляет 100 запросов в минуту на один API-ключ. При превышении возвращается ошибка 429 Too Many Requests.
• Обработка ошибок: Система использует стандартные HTTP-коды: 401 (неверный токен), 403 (нет прав), 404 (ресурс не найден), 500 (внутренняя ошибка сервера).
• Вебхуки (Webhooks): Система поддерживает подписку на события appointment_created, patient_updated. URL для callback-обработчика задается в панели управления.
• Версионирование: API использует версионирование через URL (например, /api/v1/...). Изменения в API не ломают текущие методы, новые параметры добавляются без нарушения обратной совместимости.
• Тестовая среда: Доступна песочница (Sandbox) с зеркальной структурой базы данных для отладки интеграции без затрагивания реальных записей.

Часто задаваемые вопросы о Avtomatizaciya-Kliniki

Как получить API-ключ для интеграции?
Ключ генерируется в разделе «Настройки интеграций» административной панели МИС. Необходимо выдать права на доступ к конкретным модулям (например, только чтение расписания).

Какие есть лимиты на количество обращений к API?
Базовый лимит составляет 6000 запросов в час. При необходимости проведения массового импорта данных лимиты могут быть временно расширены по запросу в техническую поддержку.

Поддерживает ли API передачу файлов?
Да, через метод POST /api/v1/files/upload можно передавать документы и результаты исследований в формате PDF или DICOM до 15 Мб за один запрос.

Есть ли готовая документация в формате Swagger?
Да, актуальная документация с примерами запросов доступна по адресу api.avtomatizaciya-kliniki.ru/docs. Она содержит интерактивную консоль для тестирования запросов в реальном времени.

Сохраняется ли работоспособность API при обновлении МИС?
Да, API является независимым слоем системы. Плановые обновления основной версии МИС не влияют на контракты методов версий v1 и v2.

Как отслеживать статус доставки вебхука?
В панели управления МИС доступен лог исходящих вебхуков с указанием HTTP-кода ответа от вашего сервера. Настроить интеграцию Avtomatizaciya-Kliniki под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.