MAPAGKUKUNAN NG API

Mga Pasyente

File ng pasyente: demograpikong impormasyon, anamnesis/allergy, medikal na kasaysayan at mga dokumento. Bawat tala ay nakabukod sa inyong klinika; ang pagbura ay maibabalik na arkibo (walang hard-delete).

Maagang Access Buong API

Mga Endpoint

9 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 Kinukuha ang listahan ng pasyente nang may pahina Lahat ng awtorisadong role

POST /v1/patients Gumagawa ng bagong tala ng pasyente admin · sekretarya · doktor

GET /v1/patients/{id} Kinukuha ang detalye ng isang pasyente Lahat ng awtorisadong role

PUT /v1/patients/{id} Ina-update ang impormasyon ng pasyente admin · sekretarya · doktor

DELETE /v1/patients/{id} Ina-arkibo ang pasyente (soft-delete) admin

GET /v1/patients/{id}/medical Inililista ang anamnesis, allergy at medikal na kasaysayan Lahat ng awtorisadong role

POST /v1/patients/{id}/medical Nagdaragdag ng medikal/anamnesis na tala admin · doktor

GET /v1/patients/{id}/documents Inililista ang mga dokumento ng pasyente Lahat ng awtorisadong role

POST /v1/patients/{id}/documents Nagdaragdag ng dokumento sa pasyente admin · sekretarya

Halimbawang Paggamit

Gumawa ng bagong pasyente

Request

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

Sagot

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

Seguridad sa mapagkukunang ito

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

Isolation ng datos: ang lahat ng query ng pasyente ay limitado sa antas ng row (RLS) sa klinikang naka-ugnay sa key; hindi kailanman ibinabalik ang pasyente ng ibang klinika.

Awtorisasyon batay sa role: paggawa/pag-update ay admin, sekretarya o doktor; ang pagbura ay admin lamang. Ang awtorisasyon ay ipinatutupad sa antas ng API.

Ang sensitibong datos (TCKN, datos ng kalusugan) ay minamaskara at hindi isinusulat nang raw sa audit record.

Ang pagbura = soft-delete (deleted_at); ang tala ay ina-anonymize, hindi pisikal na binubura (sang-ayon sa KVKK).

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

Pag-iiskedyul & Kalendaryo Odontogram & Paggamot 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