SUMBER API

Odontogram & Perawatan

Peta gigi FDI, katalog layanan/tindakan, rencana perawatan bertahap, dan resep. Status gigi disimpan secara append-only — riwayat tidak dihapus, tidak ditimpa.

Akses Awal Seluruh API

Endpoint

14 endpoint

Endpoint milik sumber ini. Setiap endpoint dibatasi pada data klinik yang terkait dengan kunci API; endpoint penulisan mendukung header Idempotency-Key.

GET /v1/patients/{id}/odontogram Mengambil peta gigi FDI terkini Semua peran berwenang

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

GET /v1/patients/{id}/odontogram/{tooth}/history Mengambil riwayat status suatu gigi Semua peran berwenang

GET /v1/services Mencantumkan katalog layanan/tindakan Semua peran berwenang

POST /v1/services Menambahkan item layanan admin

PUT /v1/services/{id} Memperbarui item layanan admin

GET /v1/patients/{id}/plans Mencantumkan rencana perawatan pasien Semua peran berwenang

POST /v1/patients/{id}/plans Membuat rencana perawatan admin · dokter

GET /v1/plans/{id} Mengambil detail rencana perawatan Semua peran berwenang

POST /v1/plans/{id}/status Mengubah status rencana admin · dokter

POST /v1/plans/{id}/items Menambahkan tahap/item ke rencana admin · dokter

POST /v1/plan-items/{id}/status Mengubah status item rencana admin · dokter

GET /v1/patients/{id}/prescriptions Mencantumkan resep Semua peran berwenang

POST /v1/patients/{id}/prescriptions Membuat resep admin · dokter

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

Keamanan pada sumber ini

Keamanan bukanlah sebuah fitur, melainkan arsitektur itu sendiri. Jaminan yang berlaku pada sumber ini:

Catatan status gigi bersifat append-only: setiap perubahan ditambahkan sebagai baris baru, catatan lama tidak dapat diubah (integritas riwayat klinis).

Pembuatan rencana perawatan dan resep hanya terbuka untuk peran admin/dokter; logika harga dan tahap dijalankan di server.

Semua catatan terisolasi pada klinik Anda; perhitungan harga rencana tidak diambil dari klien, dilakukan di server dengan numeric.

Seluruh model keamanan →

Format Kesalahan

Kesalahan dikembalikan dengan amplop yang konsisten; kode ditujukan ke mesin, pesan ke pengguna. Kesalahan/stack internal tidak pernah bocor.

{
  "error": {
    "code": "validation_failed",
    "message": "Bidang tidak valid: e-mail"
  }
}

Sumber Daya Lainnya

Pasien Janji Temu & Kalender Penagihan & Keuangan Inventaris Pencitraan Lab Lead & CRM Wisata Kesehatan Pelaporan & BI Webhooks Transfer Data (Export API)

Ingin akses awal?

Jadilah yang pertama tahu saat API dibuka.

Hubungi