РЕСУРС API

Снимки

Рентгеновские снимки и клинические фотографии привязываются к карте пациента. Файлы хранятся в S3-совместимом объектном хранилище; никогда в базе данных.

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

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

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

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

GET /v1/patients/{id}/images Выводит список изображений пациента (рентген/фото) Все авторизованные роли

POST /v1/patients/{id}/images Загружает изображение (S3, stream/presigned) admin · врач · секретарь

GET /v1/images/{id}/raw Скачивает файл изображения (presigned) Все авторизованные роли

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

Вывести список изображений пациента

Запрос

curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"

Ответ

HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

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

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

Большие файлы (рентгеновские снимки) не записываются на диск BFF; они передаются напрямую в S3 через stream/presigned.

Доступ к исходному файлу предоставляется по временной подписанной (presigned) ссылке; даже при утечке ссылки её срок действия истекает.

Все изображения изолированы по пациенту и клинике (RLS); неавторизованная клиника не имеет доступа.

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

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

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

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

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

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

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

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

Связаться