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": "Жарамсыз өріс: электрондық пошта"
  }
}

Басқа Ресурстар

Науқастар Қабылдау & Күнтізбе Одонтограмма & Емдеу Төлем және Қаржы Қор Зертхана Lead & CRM Медициналық туризм Есеп беру & BI Webhooks Деректерді Тасымалдау (Export API)

Ерте қатынау қалайсыз ба?

API ашылғанда алдымен сіз хабардар болыңыз.

Байланысу