SUMBER API

Pengimejan

X-ray dan foto klinikal dipautkan ke fail pesakit. Fail disimpan dalam storan objek serasi-S3; tidak sekali-kali dalam pangkalan data.

Akses Awal Semua API

Titik Akhir

3 titik akhir

Titik akhir bagi sumber ini. Setiap titik akhir terhad kepada data klinik yang dikaitkan dengan kunci API; titik akhir penulisan menyokong pengepala Idempotency-Key.

GET /v1/patients/{id}/images Menyenaraikan imej pesakit (X-ray/foto) Semua peranan yang dibenarkan

POST /v1/patients/{id}/images Memuat naik imej (S3, stream/presigned) admin · doktor · setiausaha

GET /v1/images/{id}/raw Memuat turun fail imej (presigned) Semua peranan yang dibenarkan

Contoh Penggunaan

Senaraikan imej pesakit

Permintaan

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

Respons

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

Keselamatan dalam sumber ini

Keselamatan bukanlah satu ciri, tetapi seni bina itu sendiri. Jaminan yang terpakai dalam sumber ini:

Fail besar (X-ray) tidak ditulis ke cakera BFF; ia dihantar terus ke S3 sebagai stream/presigned.

Capaian fail mentah diberikan melalui pautan bertandatangan bertempoh (presigned); walaupun pautan bocor, tempohnya akan luput.

Semua imej terpencil kepada pesakit dan klinik (RLS); klinik yang tidak dibenarkan tidak boleh mencapainya.

Seluruh model keselamatan →

Format Ralat

Ralat dipulangkan dengan sampul yang tekal; kod ditujukan kepada mesin, mesej kepada pengguna. Ralat dalaman/stack tidak sekali-kali dibocorkan.

{
  "error": {
    "code": "validation_failed",
    "message": "Medan tidak sah: e-mel"
  }
}

Sumber Lain

Pesakit Penjadualan & Kalendar Odontogram & Rawatan Kutipan & Kewangan Stok Makmal Lead & CRM Pelancongan Kesihatan Pelaporan & BI Webhooks Pemindahan Data (Export API)

Mahukan akses awal?

Jadilah orang pertama yang tahu apabila API dibuka.

Hubungi kami