İmza Yeri'nde İmza Sonrası Çağrı Adresi (Webhook) Tanımlama

İmza Yeri'nin, belgeleriniz imzalandığında sizin sisteminize otomatik bildirim (webhook) göndermesi için çağrı adresi tanımlamayı öğrenin.

Bu ayar yalnızca API erişimi açık olan hesaplarda görünür. API erişimi için teklif alın.

Bildirimde gelen belgeye API ile erişmek için bir API anahtarına ihtiyacınız vardır. Anahtar oluşturma adımları için İmza Yeri'nde API Anahtarı Oluşturma makalesine göz atın.

Çağrı adresini tanımlama

1. İmza Yeri hesabınıza giriş yapın ve Hesabım sayfasını açın.

2. API Anahtarı bölümüne gidin.

3. İmza Sonrası Çağrı Adresi (Post) alanına bildirimlerin gönderileceği adresi girin.

4. Kaydet'e tıklayın. "Geri dönüş adresi kaydedildi." mesajı görüntülenir.

5. İsterseniz İmzalama Sonrası Geri Dönüş Adresi alanına, imzalayan kişinin imzadan sonra tarayıcıda yönlendirileceği adresi girip Kaydet'e tıklayın.

Bildirimin içeriği

Bir alıcı belgeyi her imzaladığında, çağrı adresinize JSON biçiminde bir POST isteği gönderilir:

[
  {
    "job_id": 12345,
    "job_status": "IN_PROGRESS",
    "recipients": [
      { "recipient_id": 111, "recipient_status": "SIGNED" },
      { "recipient_id": 112, "recipient_status": "WAITING" }
    ],
    "documents": [
      { "document_id": 6789 }
    ]
  }
]

Tüm alıcılar imzaladığında job_status değeri COMPLETED olur. Belgenin dosyalarını API ile GET /jobs/{id}/documents uç noktasından listeleyebilir, imzalı belgeyi GET /documents/{id}/download uç noktasıyla indirebilirsiniz.

Bildirim yalnızca imza işlemlerinde gönderilir; belge reddedildiğinde bildirim gönderilmez.

Çağrı adresinize ulaşılamazsa bildirim tekrar gönderilmez. Bildirimi kaçırdığınızı düşünüyorsanız belgenin durumunu API ile sorgulayın.

Yardıma mı ihtiyacınız var?

Sayfanın sağ alt köşesindeki sohbet butonuna tıklayarak bize canlı destek üzerinden hemen ulaşabilirsiniz.