🚀 Dijital dönüşümünüze bugün başlayın! İlk 3 kredi ücretsiz - Hemen deneyin!

Gerçek Zamanlı Olay Bildirimleri

Güçlü Webhook Entegrasyonu

E-imza olaylarını gerçek zamanlı olarak sistemlerinize iletin. Webhook'lar ile iş süreçlerinizi tamamen otomatikleştirin.

app.imzala.org

SÖZLEŞME

İMZALA
Ürüne Genel Bakış

Webhook Entegrasyonu Nedir?

Imzala.org Webhook entegrasyonu, e-imza süreçlerinizdeki önemli olayları (belge imzalandı, reddedildi, süresi doldu vb.) gerçek zamanlı olarak kendi sistemlerinize iletmenizi sağlayan güçlü bir araçtır. HTTP POST istekleri ile anında bildirim alarak süreçlerinizi otomatikleştirebilirsiniz.

Gerçek Zamanlı

Olaylar gerçekleştiği anda sistemlerinize anında iletilir

Güvenli İletim

HMAC imzalama ve SSL şifreleme ile güvenli veri transferi

Yeniden Deneme

Başarısız istekler için otomatik yeniden deneme mekanizması

Webhook Özellikleri

Gerçek Zamanlı Bildirim

Olaylar gerçekleştiği anda sistemlerinize anında iletilir

Güvenli İletim

HMAC imzalama ve SSL şifreleme ile güvenli veri transferi

Yeniden Deneme

Başarısız istekler için otomatik yeniden deneme mekanizması

Olay Filtreleme

Sadece ilgilendiğiniz olayları alın, gereksiz trafikten kaçının

Detaylı Payload

Zengin JSON payload ile tüm olay detaylarına erişim

Test Ortamı

Webhook'larınızı test edebileceğiniz sandbox ortamı

Faydalar

Webhook Entegrasyonu Avantajları

Tam Otomasyon

Manuel kontrol gerektirmeden süreçleri otomatik yönetin

Anlık Tepki

Olaylara saniyeler içinde tepki verin

Kaynak Tasarrufu

Polling yerine push bildirimleri ile sistem kaynaklarını koruyun

Özelleştirilebilir

İhtiyacınıza göre webhook ayarlarını yapılandırın

Olay Bazlı Filtreleme

Yalnızca ilgilendiğiniz olay türlerini seçerek gereksiz bildirim trafiğini azaltın.

Tekrarlı Teslimat Kontrolü

Benzersiz X-Imzala-Delivery kimliğiyle yinelenen webhook teslimlerini tanıyın ve her olayı bir kez işleyin.

Webhook Olayları

Takip edebileceğiniz tüm e-imza olayları

demand.created

Yeni bir sözleşme (demand) oluşturulduğunda tetiklenir

party.viewed

Bir taraf belgeyi görüntülediğinde tetiklenir

party.signed

Bir taraf belgeyi imzaladığında tetiklenir

party.rejected

Bir taraf imzayı reddettiğinde tetiklenir

demand.completed

Tüm taraflar imzaladığında ve sözleşme tamamlandığında tetiklenir

demand.expired

Sözleşmenin imza süresi dolduğunda tetiklenir

Teknik Detaylar

Teknik Özellikler ve Güvenlik

Enterprise seviye güvenlik ve performans standartlarıyla tasarlanmış webhook sistemi.

teknik-özellikler.json
Güvenlik HMAC-SHA256 imzalama
Protokol HTTPS POST
Format JSON (UTF-8)
Timeout 5 saniye
Yeniden Deneme 6 deneme (artan bekleme: 30sn → 2sa)
İmza Header'ı X-Imzala-Signature-256 (sha256=...)
Idempotency X-Imzala-Delivery (benzersiz teslim kimliği)
Olay Tipleri 6 olay tipi

Webhook Implementasyonu

Webhook Endpoint Örneği (Node.js)

javascript

                const express = require('express');
const crypto = require('crypto');
const app = express();

// HMAC için ham gövde gerekir (parse edilmeden ÖNCE)
app.post('/webhook/imzala', express.raw({ type: 'application/json' }), (req, res) => {
  const header = req.headers['x-imzala-signature-256'] || '';
  const expected = 'sha256=' + crypto
    .createHmac('sha256', process.env.WEBHOOK_SECRET)
    .update(req.body) // ham gövde (Buffer)
    .digest('hex');

  if (header !== expected) {
    return res.status(401).send('Unauthorized');
  }

  const payload = JSON.parse(req.body);
  const eventType = req.headers['x-imzala-event'];
  const deliveryId = req.headers['x-imzala-delivery']; // idempotency

  switch (eventType) {
    case 'party.signed':
      console.log(`Bir taraf imzaladı: ${payload.data.demand_id}`);
      break;
    case 'demand.completed':
      console.log(`Sözleşme tamamlandı: ${payload.data.demand_id}`);
      break;
  }

  res.status(200).send('OK');
});

              

Webhook Payload Örneği

json

                {
  "id": "evt_3f9a1234567890",
  "type": "demand.completed",
  "created_at": "2026-06-29T10:30:00.000Z",
  "data": {
    "demand_id": "uuid",
    "status": "COMPLETED",
    "completed_at": "2026-06-29T10:30:00Z",
    "parties": [
      {
        "id": "uuid",
        "name": "Mehmet Yılmaz",
        "email": "[email protected]",
        "signed_at": "2026-06-29T10:29:45Z"
      }
    ]
  }
}

              

Webhook Kurulum Süreci

  1. 1

    Endpoint Oluşturun

    Webhook isteklerini alacak HTTPS endpoint'inizi hazırlayın

  2. 2

    Webhook Kaydı

    Imzala.org panelinden veya API ile webhook URL'nizi kaydedin

  3. 3

    Olay Seçimi

    Dinlemek istediğiniz olayları seçin

  4. 4

    Test Edin

    Test webhook'ları göndererek entegrasyonunuzu doğrulayın

  5. 5

    Canlıya Alın

    Webhook'larınız hazır, gerçek olayları almaya başlayın

En İyi Uygulamalar

Güvenlik

Her zaman HMAC imzasını doğrulayın ve HTTPS kullanın

Idempotency

Aynı X-Imzala-Delivery kimliğiyle gelen tekrarlı teslimleri bir kez işleyin

Hızlı Yanıt

Webhook'a 5 saniye içinde 2xx yanıt verin

Asenkron İşleme

Uzun süren işlemleri kuyruk sistemine alın

Hata Yönetimi

Hataları loglamayı ve monitör etmeyi unutmayın

Yedekleme

Kritik webhook'lar için yedek endpoint kullanın

SSS

Sıkça Sorulan Sorular

Webhook güvenliği nasıl sağlanıyor?

Her webhook isteği HMAC-SHA256 ile imzalanır. Ayrıca IP whitelist, API Key kimlik doğrulama ve SSL/TLS şifreleme kullanarak ekstra güvenlik katmanları sağlıyoruz.

Webhook isteği başarısız olursa ne olur?

Başarısız istekler için artan beklemeyle (yaklaşık 30 saniye, 2 dakika, 10 dakika, 30 dakika, 2 saat) toplam 6 deneme yapılır. Ardışık başarısızlıklarda webhook için uyarı üretilir ve panelden teslim kayıtlarını inceleyebilirsiniz.

Hangi formatta veri gönderiliyor?

Tüm webhook verileri JSON formatında, UTF-8 encoding ile gönderilir. Content-Type header'ı her zaman 'application/json' olarak ayarlanır.

Test webhook'ları gönderebilir miyim?

Evet, kontrol panelinizden veya API üzerinden test webhook'ları gönderebilirsiniz. Ayrıca webhook.site gibi araçlarla test yapabilirsiniz.

Webhook event'larını filtreleyebilir miyim?

Evet, sadece ilgilendiğiniz event türlerini seçebilirsiniz. Bu sayede gereksiz webhook trafiğinden kaçınabilirsiniz.

Webhook'larla Süreçlerinizi Otomatikleştirin

✅ Kredi kartı gerekmez • ✅ Türkçe destek dahil ✅ 6 olay tipi • ✅ HMAC-SHA256 imzalı + artan beklemeli yeniden deneme ✅ KVKK uyumlu güvenlik

5070 sayılı Kanun & KVKK uyumlu · TÜBİTAK zaman damgası

Demo Talep Et

15 dakikalık ücretsiz demo ile imzala.org'un kurumunuza nasıl uyduğunu birlikte görelim.

E-posta veya telefondan en az birini doldurun.

Fiyat Teklifi İsteyin

İmza hacminize ve iş akışınıza göre size özel bir fiyat teklifi hazırlayalım.

E-posta veya telefondan en az birini doldurun.

Talebinizi yanıtlamak için ilettiğiniz bilgileri işleriz; ayrıntılar: KVKK Aydınlatma Metni ve Gizlilik Politikası.