SUMBER API

Webhooks

Ketika peristiwa terjadi di klinik Anda, sebuah notifikasi bertanda tangan dikirim ke alamat terdaftar Anda; dengan begitu sistem Anda sendiri selalu diperbarui secara real time.

Akses Awal Seluruh API

Endpoint

3 endpoint

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

GET /v1/webhooks Mencantumkan langganan webhook yang terdaftar admin

POST /v1/webhooks Mendaftarkan webhook untuk notifikasi peristiwa admin

DELETE /v1/webhooks/{id} Menghapus langganan webhook admin

Contoh Penggunaan

Daftarkan webhook

Permintaan

curl -X POST https://api.udentiva.com/v1/webhooks \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://siz.example/hook","events":["payment.created"]}'

Respons

HTTP/1.1 201 Created
{
  "id": "wh-1",
  "url": "https://siz.example/hook",
  "events": ["payment.created"],
  "secret": "whsec_xxx"
}

Keamanan pada sumber ini

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

Setiap notifikasi ditandatangani dengan kunci rahasia bersama (HMAC); dengan memverifikasi tanda tangan, Anda memastikan permintaan benar-benar berasal dari UDENTIVA.

Aman untuk pengiriman ulang: setiap peristiwa memiliki identitas unik; Anda dapat menyaring pengiriman duplikat berdasarkan identitas tersebut (konsumsi idempoten).

Langganan webhook terisolasi pada klinik Anda; Anda hanya menerima peristiwa milik Anda sendiri.

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 Odontogram & Perawatan Penagihan & Keuangan Inventaris Pencitraan Lab Lead & CRM Wisata Kesehatan Pelaporan & BI Transfer Data (Export API)

Ingin akses awal?

Jadilah yang pertama tahu saat API dibuka.

Hubungi