MAPAGKUKUNAN NG API

Imaging

Ang mga x-ray at klinikal na larawan ay inuugnay sa file ng pasyente. Ang mga file ay itinatago sa S3-compatible na object storage; hindi kailanman sa database.

Maagang Access Buong API

Mga Endpoint

3 endpoint

Ang mga endpoint na nauukol sa mapagkukunang ito. Bawat endpoint ay limitado sa datos ng klinikang naka-ugnay sa API key; ang mga write endpoint ay sumusuporta sa Idempotency-Key header.

GET /v1/patients/{id}/images Inililista ang mga image (x-ray/photo) ng pasyente Lahat ng awtorisadong role

POST /v1/patients/{id}/images Nag-a-upload ng image (S3, stream/presigned) admin · doktor · sekretarya

GET /v1/images/{id}/raw Dina-download ang image file (presigned) Lahat ng awtorisadong role

Halimbawang Paggamit

Ilista ang mga image ng pasyente

Request

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

Sagot

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

Seguridad sa mapagkukunang ito

Ang seguridad ay hindi isang feature, kundi ang arkitektura mismo. Ang mga garantiyang may bisa sa mapagkukunang ito:

Ang malalaking file (x-ray) ay hindi isinusulat sa disk ng BFF; direktang ipinapadala sa S3 bilang stream/presigned.

Ang access sa raw file ay ibinibigay sa pamamagitan ng may-takda-na-oras na naka-sign na (presigned) link; kahit ma-leak ang link, mag-e-expire ito.

Ang lahat ng image ay nakabukod sa pasyente at klinika (RLS); hindi maa-access ng hindi awtorisadong klinika.

Buong modelo ng seguridad →

Format ng Error

Ang mga error ay ibinabalik sa isang tugmang envelope; ang code ay para sa makina, ang mensahe ay para sa user. Ang panloob na error/stack ay hindi kailanman tumatagas.

{
  "error": {
    "code": "validation_failed",
    "message": "Di-wastong field: email"
  }
}

Iba pang Mapagkukunan

Mga Pasyente Pag-iiskedyul & Kalendaryo Odontogram & Paggamot Koleksyon at Pananalapi Stock Laboratoryo Lead & CRM Health Tourism Pag-uulat & BI Webhooks Paglipat ng Datos (Export API)

Gusto ninyo ba ng maagang access?

Maging una kayong makaalam kapag bukas na ang API.

Makipag-ugnayan