РЕСУРС API

Webhooks

По мере наступления событий в вашей клинике на зарегистрированный адрес отправляется подписанное уведомление; вы поддерживаете собственную систему в актуальном состоянии в реальном времени.

Ранний доступ Весь API

Конечные точки

3 конечная точка

Конечные точки этого ресурса. Каждая точка ограничена данными клиники, к которой привязан ключ API; точки записи поддерживают заголовок Idempotency-Key.

GET /v1/webhooks Выводит список зарегистрированных подписок webhook admin

POST /v1/webhooks Регистрирует webhook для уведомления о событиях admin

DELETE /v1/webhooks/{id} Удаляет подписку webhook admin

Пример использования

Зарегистрировать webhook

Запрос

curl -X POST https://api.udentiva.com/v1/webhooks \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://siz.example/hook","events":["payment.created"]}'

Ответ

HTTP/1.1 201 Created
{
  "id": "wh-1",
  "url": "https://siz.example/hook",
  "events": ["payment.created"],
  "secret": "whsec_xxx"
}

Безопасность этого ресурса

Безопасность — не функция, а сама архитектура. Гарантии, действующие на этом ресурсе:

Каждое уведомление подписывается общим секретным ключом (HMAC); проверяя подпись, вы подтверждаете, что запрос действительно поступил от UDENTIVA.

Безопасно при повторной отправке: каждое событие имеет уникальный идентификатор; дублирующую доставку можно отсеять по идентификатору (идемпотентное потребление).

Подписки webhook изолированы в вашей клинике; вы получаете только собственные события.

Вся модель безопасности →

Формат ошибки

Ошибки возвращаются в согласованном конверте; код — для машины, сообщение — для пользователя. Внутренняя ошибка/стек никогда не утекает.

{
  "error": {
    "code": "validation_failed",
    "message": "Недопустимое поле: e-mail"
  }
}

Другие ресурсы

Пациенты Записи на приём и календарь Одонтограмма и лечение Инкассация и финансы Склад Снимки Лаборатория Lead и CRM Медицинский туризм Отчётность и BI Передача данных (Export API)

Хотите ранний доступ?

Узнайте об открытии API первыми.

Связаться