Gelen webhook ucu

/hooks/{org_slug}/{source} — POST

POST/hooks/{org_slug}/{source}

Gelen webhook

Siteniz “sipariş değişti” dediğinde sipariş kaydı anında tazelenir. source: woocommerce (WooCommerce’in kendi webhook’u, X-WC-Webhook-Signature) ya da generic (kendi sisteminiz, X-Zitena-Signature). Aynı teslimat kimliği 24 saat içinde ikinci kez işlenmez. Firma ya da gizli anahtar tanımlı değilse 404. Ayrıntılar: Gelen webhook rehberi.

Kimlik doğrulama: HMAC imza başlığı (API anahtarı yok).

Parametreler

Ad	Yer	Tür	Sınır	Anlamı
org_slug *	path	string		Firmanızın kısa adı (konsolda Gelen webhook sayfasındaki adreste).
source *	path	string		woocommerce ya da generic.

Örnek

SECRET=whsec_xxx
BODY='{"id": "evt-0001", "event": "order.updated", "order": {"external_id": "98765", "status": "shipped", "created_at": "2026-09-24T10:15:00+03:00", "modified_at": "2026-09-24T15:00:00+03:00", "tracking_number": "123456789012"}}'
TS=$(date +%s)
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" -hex | sed 's/^.* //')
curl -s -X POST "$RZ_API/hooks/firma/generic" -H "Content-Type: application/json" \
  -H "X-Zitena-Signature: t=$TS,v1=$SIG" -d "$BODY"

Yanıt 200

{
  "ok": true,
  "orders": 1,
  "inserted": 0,
  "updated": 1,
  "unchanged": 0
}

Hata durumları: 401, 404, 413, 422 — bkz. Hatalar ve sınırlar.

Rehber: Gelen webhook