Интеграция онлайн записи¶

Интеграция с GBooking производится через публичный API.

Разница с остальными методами для конечного пользователя заключается в том, что тут передаются идентификаторы объектов МИС.

Взаимодействие осуществляется через протокол https в обе стороны.

Интеграция предполагает, что расписание клиники в режиме реального времени будет доступно для записи конечному клиенту. При этом записи будут появляться в вашей медицинской информационной системе. Любые их изменения и отмена записи также будет отображаться на стороне используемой вами МИС.

Для интеграции сервиса GBooking и МИС используется 3 типа синхронизации:

Синхронизация расписания

Синхронизация всего объема данных по расписанию. Гарантирует, что в конечном счете данные будут синхронизированы. Используется для инициализации данных, как failover механизм. Запросы в данном разделе обладают свойством идемпотентности — и при первом и при последующих вызовах результирующее состояние системы зависит только от входных данных, но не от состояния системы до выполнения запроса.

Сервер записи на стороне клиники

Резервирование, подтверждение, изменение, отмена записи отправляются на данный сервер.

Callback механизм

Изменения расписания, добавление записей на стороне клиники отправляют запросы на GBooking API, чтобы решетка расписания была актуальной.

В случае выполнения тяжелых запросов, например, обновление схемы бизнеса, расписания вам вернется в ответ идентификатор jobID. По нему можно узнать статус выполнения задачи, используя для этого запрос business.get_bg_job_info. Данный метод вы можете использовать как в отладочных целях, так и с целью мониторинга работоспособности интеграции на вашей стороне.

Время в параметрах запроса/ответа передается в формате ISO8601.

“ping” запрос¶

Данный запрос необходим нам для мониторинга доступности вашего HTTP сервера с целью своевременного исправления ошибок передачи данных. “ping” запрос будет выполняться раз в 10 минут. Поэтому сделайте его максимально легким — выдача 200 статуса и строки “ok“.

Параметры запроса¶

GBooking API Endpoint URL — https://apiv2.gbooking.ru/rpc

Тип запроса — HTTP/1.1 POST

Обязательный HTTP заголовок — Content-Type: application/json

Формат запроса — json-rpc

С примерами запросов так же можно ознакомиться по ссылке https://documenter.getpostman.com/view/608267/6nATBX4

Переменные тестового окружения:

BusinessID: 4000000005820

Token: c368eaebc29967dd5b7bdf5eae6fc6658e73cc0f

UserID: 59955503fb1d89051031d672

Параметры доступа запроса¶

"cred":{
    "token":"[Token]",
    "user":"[UserID]"
},

Название	Required	Описание
token	обязательно	токен доступа
user	обязательно	идентификатор профиля пользователя