Webhook ve API Entegrasyonu: Teknik Kurulum Kılavuzu

Webhook entegrasyonu, dışarıdan gelen olayların (yeni sipariş, durum güncellemesi) otomatik olarak sisteminize iletilmesini sağlar. Teknik detayları anlamak, sorunsuz entegrasyon için şarttır.

Webhook Nedir?

Webhook, bir uygulama olay yaşandığında belirlediğiniz URL'e otomatik HTTP POST isteği göndermesidir. Getir sipariş onayladığında Bilecik Kurye webhook URL'inize bir POST atar — siz sorgulamak zorunda kalmazsınız.

Bilecik Kurye Webhook Formatı

Gelen webhook payload'u JSON formatındadır. Temel alanlar:

• order_id — Kaynak sistemdeki sipariş numarası
• customer_name — Müşteri adı
• customer_phone — Telefon numarası
• address — Teslimat adresi (metin veya koordinat)
• total — Sipariş tutarı
• payment_type — Ödeme yöntemi (cash/card/online)
• source — Sipariş kaynağı (getir/yemeksepeti/pos vb.)

Güvenlik: İmza Doğrulama

Her webhook isteği HMAC-SHA256 imzası içerir. Bilecik Kurye size özel secret key verir. Gelen istekte X-Signature header'ını bu key ile doğrulayın; uyuşmayan istekleri reddedebilirsiniz.

Test Yöntemleri

Entegrasyonu canlıya geçmeden önce test edin. requestbin.com veya webhook.site gibi araçlarla geçici endpoint oluşturun. Kaynak sistemden test event gönderin, payload'u inceleyin. Her şey doğruysa gerçek endpoint URL'ini girin.

API Polling (Webhook Alternatifi)

Bazı sistemler webhook desteklemez. Bu durumda Bilecik Kurye REST API'sini belirli aralıklarla sorgulayan (polling) bir yapı kurulur. Webhook kadar anlık değildir ama 30–60 saniyeik polling yeterlidir.