SUMBER API

Pesakit

Fail pesakit: maklumat demografi, anamnesis/alahan, sejarah perubatan dan dokumen. Setiap rekod terpencil kepada klinik anda; operasi pemadaman ialah pengarkiban yang boleh dipulihkan (tiada hard-delete).

Akses Awal Semua API

Titik Akhir

9 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 Mendapatkan senarai pesakit secara berhalaman Semua peranan yang dibenarkan

POST /v1/patients Mencipta rekod pesakit baharu admin · setiausaha · doktor

GET /v1/patients/{id} Mendapatkan butiran seorang pesakit Semua peranan yang dibenarkan

PUT /v1/patients/{id} Mengemas kini maklumat pesakit admin · setiausaha · doktor

DELETE /v1/patients/{id} Mengarkibkan pesakit (soft-delete) admin

GET /v1/patients/{id}/medical Menyenaraikan anamnesis, alahan dan sejarah perubatan Semua peranan yang dibenarkan

POST /v1/patients/{id}/medical Menambah rekod perubatan/anamnesis admin · doktor

GET /v1/patients/{id}/documents Menyenaraikan dokumen pesakit Semua peranan yang dibenarkan

POST /v1/patients/{id}/documents Menambah dokumen kepada pesakit admin · setiausaha

Contoh Penggunaan

Cipta pesakit baharu

Permintaan

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..."}'

Respons

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

Keselamatan dalam sumber ini

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

Pengasingan data: semua pertanyaan pesakit dihadkan pada peringkat baris (RLS) kepada klinik yang dikaitkan dengan kunci; pesakit klinik lain tidak sekali-kali dikembalikan.

Kebenaran berasaskan peranan: mencipta/mengemas kini admin, setiausaha atau doktor; memadam hanya admin. Kebenaran dikuatkuasakan pada lapisan API.

Data sensitif (TCKN, data kesihatan) ditutup dan tidak ditulis secara mentah ke rekod audit.

Pemadaman = soft-delete (deleted_at); rekod dianonimkan, tidak dipadam secara fizikal (mematuhi KVKK).

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

Penjadualan & Kalendar Odontogram & Rawatan Kutipan & Kewangan Stok Pengimejan 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