hikiehikieDeveloper Documentation
Referans

İstek başlıkları

Giden isteklerdeki tüm HTTP başlıkları ve anlamları.

Tam istek

POST /hikie/webhook HTTP/1.1
Host: sunucunuz.com
Content-Type: application/json
Accept: application/json, text/plain;q=0.9, */*;q=0.8
User-Agent: Hikie-Webhooks/2.0
Hikie-Event: order.paid
Hikie-Webhook-Id: wh_1f0c8ab29e7d453b6c1a0e94f27d3b85
Hikie-Account-Id: 6512ab3d9f1e4c0012a7bc45
Hikie-Timestamp: 1785945600
Hikie-Occurred-At: 2026-08-07T09:20:00.000Z
Hikie-Api-Version: 2026-09-04
Hikie-Signature: 4c1f9d0a7e2b8c6f1d3a5e90b47c2f8ae61d0937c5b2408fe93a17d6c2b0459e
Hikie-Delivery-Attempt: 1
Content-Length: 612

{"id":"wh_1f0c8ab29e7d453b6c1a0e94f27d3b85","event":"order.paid",...}

hikie başlıkları

BaşlıkÖrnekAnlamı
Hikie-Eventorder.paidEvent tipi. Gövdedeki event alanıyla aynı
Hikie-Webhook-Idwh_1f0c8ab2…Teslimat kimliği. Yeniden denemelerde değişmez — tekrar kontrolünüzün anahtarı
Hikie-Account-Id6512ab3d9f1e…Mağaza hesabınızın kimliği
Hikie-Timestamp1785945600İsteğin imzalandığı an, Unix saniye. İmzanın parçasıdır
Hikie-Api-Version2026-09-04Payload şemasının sürümü
Hikie-Signature4c1f9d0a…HMAC-SHA256, küçük harfli hex, 64 karakter
Hikie-Delivery-Attempt1Kaçıncı deneme. 1 ilk denemedir, en fazla 10 olur

Başlık adları büyük/küçük harf duyarsızdır (HTTP standardı). Node.js'te req.headers anahtarları küçük harflidir: req.headers['hikie-signature'].

Standart başlıklar

BaşlıkDeğerNot
Content-Typeapplication/jsonGövde her zaman JSON
User-AgentHikie-Webhooks/2.0Kimlik doğrulaması için kullanmayın — taklit edilebilir
Acceptapplication/json, text/plain;q=0.9, */*;q=0.8Yanıt gövdeniz okunmaz; ne dönerseniz dönün
Content-LengthGövde uzunluğuHam gövdeyi doğru aldığınızı kontrol etmek için karşılaştırabilirsiniz

Yeniden denemede ne değişir

Aynı teslimatın 1. ve 3. denemesi:

deneme 1 → deneme 3
  Hikie-Event: order.paid
  Hikie-Webhook-Id: wh_1f0c8ab29e7d453b6c1a0e94f27d3b85
  Hikie-Account-Id: 6512ab3d9f1e4c0012a7bc45
- Hikie-Timestamp: 1785945600
+ Hikie-Timestamp: 1785946260
  Hikie-Api-Version: 2026-09-04
- Hikie-Signature: 4c1f9d0a7e2b8c6f1d3a5e90b47c2f8ae61d0937c5b2408fe93a17d6c2b0459e
+ Hikie-Signature: 9a3e07b2c8f14d6a5b0c2e91d473a86f5c04b7e29d18a63c0f5e72d94a1830cb
- Hikie-Delivery-Attempt: 1
+ Hikie-Delivery-Attempt: 3

Gövde değişmez — bayt bayt aynıdır. Deneme sayısı bilinçli olarak gövdede değil başlıkta: böylece isterseniz gövdeyi hash'leyip tekrarları karşılaştırabilirsiniz.

Deneme sayısını kullanmak

Hikie-Delivery-Attempt işlem mantığınızı değiştirmemeli — her deneme aynı şekilde ele alınmalı. Ama loglama ve izleme için değerlidir:

const attempt = Number(req.get('Hikie-Delivery-Attempt') ?? 1);

if (attempt > 1) {
  // İlk denemede bir sorun oldu — kendi loglarınızda sebebini arayın.
  logger.warn(`[hikie] ${webhookId} yeniden deneme ${attempt}/10`);
}

if (attempt >= 8) {
  // Pencerenin sonuna yaklaşıyoruz; bir uyarı göndermek isteyebilirsiniz.
  await alertOps(`Webhook ${webhookId} 8. denemede`);
}

Yanıtınız

hikie yanıtınızın yalnızca durum kodunu okur.

NeKural
Durum koduHerhangi bir 2xx başarı
GövdeOkunmaz. Boş dönmek en iyisi
Gövde sınırı64 KB — aşarsa response_too_large hatası
BaşlıklarOkunmaz
Süre5 saniye
res.sendStatus(200); // yeterli

Ağ davranışı

KonuDeğer
Zaman aşımı5 saniye (bağlantı + yanıt toplamı)
YönlendirmeTakip edilmez (maxRedirects: 0)
Bağlantı yeniden kullanımıYok — her istek yeni bağlantı
IP aralığıSabit değil; IP izin listesi kullanmayın
HTTP sürümüHTTP/1.1
ŞemaYalnızca https:

Bu sayfada