РЕСУРС API

Пациенты

Карта пациента: демографические данные, анамнез/аллергии, медицинская история и документы. Каждая запись изолирована в вашей клинике; удаление — это обратимое архивирование (hard-delete отсутствует).

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

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

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

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

GET /v1/patients Возвращает список пациентов с постраничной разбивкой Все авторизованные роли

POST /v1/patients Создаёт запись нового пациента admin · секретарь · врач

GET /v1/patients/{id} Возвращает детали одного пациента Все авторизованные роли

PUT /v1/patients/{id} Обновляет информацию о пациенте admin · секретарь · врач

DELETE /v1/patients/{id} Архивирует пациента (soft-delete) admin

GET /v1/patients/{id}/medical Выводит список анамнеза, аллергий и медицинской истории Все авторизованные роли

POST /v1/patients/{id}/medical Добавляет медицинскую запись/анамнез admin · врач

GET /v1/patients/{id}/documents Выводит список документов пациента Все авторизованные роли

POST /v1/patients/{id}/documents Добавляет документ к пациенту admin · секретарь

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

Создать нового пациента

Запрос

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

Ответ

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

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

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

Изоляция данных: все запросы по пациентам ограничены на уровне строк (RLS) клиникой, к которой привязан ключ; пациент другой клиники никогда не возвращается.

Ролевые права: создание/обновление — admin, секретарь или врач; удаление — только admin. Права принудительно применяются на уровне API.

Чувствительные данные (TCKN, медицинские данные) маскируются и не записываются в журнал аудита в исходном виде.

Удаление = soft-delete (deleted_at); запись анонимизируется, физически не удаляется (в соответствии с KVKK).

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

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

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

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

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

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

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

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

Связаться