API MƏNBƏSİ

Webhooks

Klinikanızda hadisələr baş verdikcə qeydli ünvanınıza imzalı bildiriş göndərilir; öz sisteminizi anında güncəl saxlayırsınız.

Erkən Giriş Bütün API

Uçlar

3 uc

Bu mənbəyə aid uc nöqtələr. Hər uc, API açarının bağlı olduğu klinika verisi ilə məhduddur; yazma ucları Idempotency-Key başlığını dəstəkləyir.

GET /v1/webhooks Qeydli webhook abunəliklərini siyahılayır admin

POST /v1/webhooks Hadisə bildirişi üçün webhook qeyd edir admin

DELETE /v1/webhooks/{id} Webhook abunəliyini silir admin

Nümunə İstifadə

Webhook qeyd et

Sorğu

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

Cavab

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

Bu mənbədə təhlükəsizlik

Təhlükəsizlik bir xüsusiyyət deyil, arxitekturanın özüdür. Bu mənbədə keçərli olan zəmanətlər:

Hər bildiriş paylaşılan gizli açarla imzalanır (HMAC); imzanı doğrulayaraq sorğunun həqiqətən UDENTIVA-dan gəldiyini təsdiqləyirsiniz.

Yenidən-göndərmə təhlükəsiz: hər hadisənin unikal kimliyi var; təkrar çatdırılmanı kimlikdən ayıra bilərsiniz (idempotent istehlak).

Webhook abunəlikləri klinikanıza izolyasiya olunub; yalnız öz hadisələrinizi alırsınız.

Bütün təhlükəsizlik modeli →

Xəta Formatı

Xətalar ardıcıl bir zərf ilə qayıdır; kod maşına, mesaj istifadəçiyə yönəlikdir. Daxili xəta/stack heç vaxt sızdırılmır.

{
  "error": {
    "code": "validation_failed",
    "message": "Yanlış sahə: e-poçt"
  }
}

Digər Mənbələr

Xəstələr Görüş & Təqvim Odontoqram & Müalicə Tahsilat və Maliyyə Anbar Görüntüləmə Laboratoriya Lead & CRM Sağlamlıq Turizmi Hesabatlama & BI Veri Ötürülməsi (Export API)

Erkən giriş istəyirsiniz?

API açıldıqda ilk siz xəbərdar olun.

Əlaqə Saxla