РЕСУРС API

Записи на приём и календарь

Планирование по врачам и креслам, защита от двойного бронирования, автоматические напоминания и список ожидания. Конфликты предотвращаются на уровне базы данных.

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

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

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

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

GET /v1/appointments Выводит список приёмов по диапазону дат Все авторизованные роли

POST /v1/appointments Создаёт новый приём (с проверкой конфликтов) admin · секретарь · врач

POST /v1/appointments/{id}/status Изменяет статус приёма admin · секретарь · врач

POST /v1/appointments/{id}/reschedule Переносит приём на другое время admin · секретарь · врач

POST /v1/appointments/{id}/remind Отправляет напоминание о приёме admin · секретарь · врач

GET /v1/units Выводит список кресел/установок Все авторизованные роли

GET /v1/doctors Выводит список врачей Все авторизованные роли

GET /v1/waitlist Возвращает список ожидания Все авторизованные роли

POST /v1/waitlist Добавляет пациента в список ожидания admin · секретарь · врач

DELETE /v1/waitlist/{id} Удаляет из списка ожидания admin · секретарь · врач

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

Получить приёмы по диапазону дат

Запрос

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

Ответ

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

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

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

Двойное бронирование невозможно на уровне базы данных благодаря exclusion constraint; даже при ошибке приложения конфликтующий приём не может быть записан.

Гонка за одновременный слот предотвращается распределённой блокировкой Redis; два запроса не могут одновременно записать один и тот же слот.

Все данные о приёмах изолированы в вашей клинике (RLS); изменения статуса фиксируются в журнале аудита.

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

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

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

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

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

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

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

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

Связаться