SUMBER API

Odontogram & Rawatan

Peta gigi FDI, katalog perkhidmatan/prosedur, pelan rawatan berperingkat dan preskripsi. Status gigi disimpan secara append-only — sejarah tidak dipadam, tidak ditulis ganti.

Akses Awal Semua API

Titik Akhir

14 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}/odontogram Mendapatkan peta gigi FDI semasa Semua peranan yang dibenarkan

POST /v1/patients/{id}/odontogram Menambah status gigi (append-only) admin · doktor

GET /v1/patients/{id}/odontogram/{tooth}/history Mendapatkan sejarah status sesuatu gigi Semua peranan yang dibenarkan

GET /v1/services Menyenaraikan katalog perkhidmatan/prosedur Semua peranan yang dibenarkan

POST /v1/services Menambah item perkhidmatan admin

PUT /v1/services/{id} Mengemas kini item perkhidmatan admin

GET /v1/patients/{id}/plans Menyenaraikan pelan rawatan pesakit Semua peranan yang dibenarkan

POST /v1/patients/{id}/plans Mencipta pelan rawatan admin · doktor

GET /v1/plans/{id} Mendapatkan butiran pelan rawatan Semua peranan yang dibenarkan

POST /v1/plans/{id}/status Menukar status pelan admin · doktor

POST /v1/plans/{id}/items Menambah peringkat/item kepada pelan admin · doktor

POST /v1/plan-items/{id}/status Menukar status item pelan admin · doktor

GET /v1/patients/{id}/prescriptions Menyenaraikan preskripsi Semua peranan yang dibenarkan

POST /v1/patients/{id}/prescriptions Mencipta preskripsi admin · doktor

Contoh Penggunaan

Tambah status gigi (append-only)

Permintaan

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

Respons

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

Keselamatan dalam sumber ini

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

Rekod status gigi bersifat append-only: setiap perubahan ditambah sebagai baris baharu, rekod lama tidak boleh diubah (integriti sejarah klinikal).

Penciptaan pelan rawatan dan preskripsi hanya terbuka kepada peranan admin/doktor; logik harga dan peringkat dilaksanakan pada pelayan.

Semua rekod terpencil kepada klinik anda; kiraan pelan-harga tidak diambil daripada klien, dilakukan pada pelayan dengan numeric.

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 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