MAPAGKUKUNAN NG API

Odontogram & Paggamot

FDI dental chart, katalogo ng serbisyo/prosedyur, yugtu-yugtong treatment plan at reseta. Ang mga estado ng ngipin ay itinatago bilang append-only — hindi binubura ang kasaysayan, hindi isinusulat sa ibabaw.

Maagang Access Buong API

Mga Endpoint

14 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}/odontogram Kinukuha ang kasalukuyang FDI dental chart Lahat ng awtorisadong role

POST /v1/patients/{id}/odontogram Nagdaragdag ng estado ng ngipin (append-only) admin · doktor

GET /v1/patients/{id}/odontogram/{tooth}/history Kinukuha ang kasaysayan ng estado ng isang ngipin Lahat ng awtorisadong role

GET /v1/services Inililista ang katalogo ng serbisyo/prosedyur Lahat ng awtorisadong role

POST /v1/services Nagdaragdag ng service item admin

PUT /v1/services/{id} Ina-update ang service item admin

GET /v1/patients/{id}/plans Inililista ang mga treatment plan ng pasyente Lahat ng awtorisadong role

POST /v1/patients/{id}/plans Gumagawa ng treatment plan admin · doktor

GET /v1/plans/{id} Kinukuha ang detalye ng treatment plan Lahat ng awtorisadong role

POST /v1/plans/{id}/status Binabago ang katayuan ng plano admin · doktor

POST /v1/plans/{id}/items Nagdaragdag ng yugto/item sa plano admin · doktor

POST /v1/plan-items/{id}/status Binabago ang katayuan ng plan item admin · doktor

GET /v1/patients/{id}/prescriptions Inililista ang mga reseta Lahat ng awtorisadong role

POST /v1/patients/{id}/prescriptions Gumagawa ng reseta admin · doktor

Halimbawang Paggamit

Magdagdag ng estado ng ngipin (append-only)

Request

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

Sagot

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

Seguridad sa mapagkukunang ito

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

Ang mga tala ng estado ng ngipin ay append-only: bawat pagbabago ay idinadagdag bilang bagong row, hindi mababago ang lumang tala (integridad ng klinikal na kasaysayan).

Ang paggawa ng treatment plan at reseta ay bukas lamang sa role na admin/doktor; ang lohika ng presyo at yugto ay pinatatakbo sa server.

Ang lahat ng tala ay nakabukod sa inyong klinika; ang mga kalkulasyon ng plan-price ay hindi kinukuha mula sa kliyente, ginagawa sa server gamit ang numeric.

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 Koleksyon at Pananalapi Stock Imaging 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