​
Webhooks

Webhook, Hemen Mağaza içinde gerçekleşen önemli olayları dış sistemlere HTTP isteğiyle bildiren mekanizmadır.

​
Desteklenen eventler

Başlangıç event seti:
  • order.created
  • order.paid
  • order.cancelled
  • product.updated
  • stock.changed

​
Webhook endpoint kaydı

curl -X POST "https://api.hemenmagaza.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "url": "https://example.com/webhooks/hemen-magaza",
    "events": ["order.created", "order.paid", "product.updated"]
  }'

​
Payload örneği

{
  "id": "evt_01HZ...",
  "event": "order.created",
  "created_at": "2026-06-03T10:15:00Z",
  "data": {
    "order_id": 9001,
    "status": "pending",
    "total": 1199.8,
    "currency": "TRY"
  }
}

​
Güvenlik önerisi

Webhook endpointiniz gelen isteğin gerçekten Hemen Mağaza tarafından gönderildiğini doğrulamalıdır. Production entegrasyonunda imza doğrulama kullanılmalıdır. Önerilen kontrol başlıkları: 
X-Hemen-Event
X-Hemen-Signature
X-Hemen-Timestamp

​
Retry mantığı

Webhook teslimatı geçici olarak başarısız olursa sistem yeniden deneme kuyruğuna alabilir. Bu bölümdeki retry zamanlaması ve maksimum deneme sayısı production ayarları netleştikçe genişletilecektir. Webhook endpointiniz aynı event birden fazla kez gelirse güvenli çalışmalıdır. Bunun için id alanını idempotency anahtarı gibi saklamanız önerilir.