Giriş

Bu portal kimin için

Bu portal, Haldeki ile webhook/API entegrasyonu kuran kurye ve entegratör partnerlerine yöneliktir. Sipariş durum bildirimleri, kimlik doğrulama ve sürümleme kuralları gibi Haldeki'nin dışa verdiği sözleşmeleri belgeler.

Base URL

Tüm uç noktalar aynı kökten sunulur:

https://haldeki.com

Sürümleme

Sürüm bilginin URL'de path segmenti olarak taşınır, ör. /api/webhooks/v1/.... Kırıcı bir değişiklik gerektiğinde yeni bir v2 path'i açılır; eski v1 path'i en az 6 ay çalışır durumda kalmaya devam eder. Alan eklemek (yeni JSON field, yeni action) kırıcı sayılmaz ve sürüm artırmaz.

Kimlik doğrulama (özet)

Her istek, partner ile Haldeki arasında paylaşılan bir secret ile imzalanır ve x-provider-signature header'ında taşınır:

x-provider-signature: hex( HMAC-SHA256( raw_body, secret ) )

Opsiyonel x-webhook-timestamp header'ı (unix saniye) eklenirse imza güçlendirilmiş modda hesaplanır ve ±5 dakika tazelik penceresi dışındaki istekler reddedilir (replay koruması). Detaylar için bkz. Kurye Webhook v1.

Entegrasyon akışı

1. Hesap açılışı — Haldeki tarafında partner hesabı ve sağlayıcı (provider) anahtarı oluşturulur.
2. URL + secret teslimi — hesaba özel webhook URL'i ({slug} içerir) ve paylaşılan secret partnere iletilir.
3. Kayıt doğrulama — partner validate aksiyonuna istek atarak elindeki secret ve işletme kimliğinin doğru olduğunu teyit eder.
4. Canlıya alma — doğrulama başarılıysa entegrasyon canlıya alınır, sipariş durum bildirimleri akmaya başlar.

Uç nokta bazlı detaylar için: Kurye Webhook v1.