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 | Örnek | Anlamı |
|---|---|---|
Hikie-Event | order.paid | Event tipi. Gövdedeki event alanıyla aynı |
Hikie-Webhook-Id | wh_1f0c8ab2… | Teslimat kimliği. Yeniden denemelerde değişmez — tekrar kontrolünüzün anahtarı |
Hikie-Account-Id | 6512ab3d9f1e… | Mağaza hesabınızın kimliği |
Hikie-Timestamp | 1785945600 | İsteğin imzalandığı an, Unix saniye. İmzanın parçasıdır |
Hikie-Api-Version | 2026-09-04 | Payload şemasının sürümü |
Hikie-Signature | 4c1f9d0a… | HMAC-SHA256, küçük harfli hex, 64 karakter |
Hikie-Delivery-Attempt | 1 | Kaçı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ık | Değer | Not |
|---|---|---|
Content-Type | application/json | Gövde her zaman JSON |
User-Agent | Hikie-Webhooks/2.0 | Kimlik doğrulaması için kullanmayın — taklit edilebilir |
Accept | application/json, text/plain;q=0.9, */*;q=0.8 | Yanıt gövdeniz okunmaz; ne dönerseniz dönün |
Content-Length | Gövde uzunluğu | Ham 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:
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: 3Gö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.
| Ne | Kural |
|---|---|
| Durum kodu | Herhangi bir 2xx başarı |
| Gövde | Okunmaz. Boş dönmek en iyisi |
| Gövde sınırı | 64 KB — aşarsa response_too_large hatası |
| Başlıklar | Okunmaz |
| Süre | 5 saniye |
res.sendStatus(200); // yeterliAğ davranışı
| Konu | Değer |
|---|---|
| Zaman aşımı | 5 saniye (bağlantı + yanıt toplamı) |
| Yönlendirme | Takip 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 |
| Şema | Yalnızca https: |