hikiehikieDeveloper Documentation
Nasıl çalışır

Teslimat ve yeniden deneme

Sunucunuz yanıt vermezse ne olur — 10 deneme, 72 saatlik pencere, kalıcı ve geçici hata ayrımı.

Başarı ölçütü

Herhangi bir 2xx yanıtı başarı sayılır. 200, 201, 204 — hepsi aynıdır. Gövde okunmaz; boş yanıt dönebilirsiniz.

Yanıt 5 saniye içinde dönmelidir. Bu süre dolduğunda istek iptal edilir ve zaman aşımı sayılır — sunucunuz işi tamamlamış olsa bile.

Yeniden deneme takvimi

İlk denemeden itibaren geçen süre olarak:

Denemeİlk denemeden sonraAradaki bekleme
10—
21 dakika1 dakika
310 dakika9 dakika
41 saat50 dakika
52 saat1 saat
64 saat2 saat
78 saat4 saat
824 saat16 saat
948 saat24 saat
1072 saat24 saat

Toplam 10 deneme, 72 saatlik pencere. Onuncu deneme de başarısız olursa teslimat exhausted olur ve bir daha denenmez.

Bu takvim, kısa kesintileri dakikalar içinde, uzun kesintileri ise günler içinde tolere edecek şekilde tasarlandı. Sunucunuz bir saatliğine kapansa bile teslimat kaybolmaz.

Kalıcı ve geçici hatalar

Her hata yeniden denenmez. Bazı yanıtlar "tekrar denemek aynı sonucu verir" anlamına gelir; zinciri orada keseriz.

flowchart TD
A["Yanıt geldi"] --> B{"Durum kodu?"}
B -->|"2xx"| C["delivered — bitti"]
B -->|"3xx"| D["KALICI — yönlendirme takip edilmez"]
B -->|"400, 401, 403,<br/>404, 410, 422"| E["KALICI — istek kabul edilmiyor"]
B -->|"408, 429, diğer 4xx"| F["GEÇİCİ — yeniden denenir"]
B -->|"5xx"| F
A2["Yanıt gelmedi<br/>timeout / DNS / TLS / bağlantı"] --> F
F --> G{"10. deneme miydi?"}
G -->|"hayır"| H["retrying — takvime göre bekle"]
G -->|"evet"| I["exhausted — vazgeçildi"]

Kalıcı sayılan yanıtlar

KodAnlamıNe yapmalısınız
3xxYönlendirmeNihai adresi abonelikte doğrudan yazın; yönlendirme takip edilmez
400İstek anlaşılamadıGövde çözümlemenizi kontrol edin
401YetkisizEndpoint'iniz hikie'nin gönderemeyeceği bir kimlik doğrulaması bekliyor
403YasakGüvenlik duvarı / WAF isteği engelliyor olabilir
404BulunamadıAbonelikteki yol yanlış
410Kalıcı olarak gittiEndpoint kapatılmış
422İşlenemeyen içerikDoğrulamanız gövdeyi reddediyor

401 ve 403 dönmek cazip gelebilir ("imza tutmadı, yetkisiz diyeyim"), ama bunlar kalıcı hata sayılır ve aboneliğinizi hızla failing durumuna iter. İmza doğrulaması sizin tarafınızdaki bir hata yüzünden başarısız oluyorsa 400 daha doğru bir cevaptır; geçici bir sorunsa 503 dönüp yeniden denenmesini sağlayın.

Geçici sayılan hatalar

Ağ seviyesindeki her şey ve 5xx yanıtlar geçicidir — sunucu şu an kapalı olabilir, 72 saatlik pencerede geri gelebilir.

Hata sınıfıNe demek
timeout5 saniyede yanıt gelmedi
dnsAlan adı çözümlenemedi
tlsSertifika geçersiz, süresi dolmuş veya alan adıyla eşleşmiyor
connectionBağlantı reddedildi / sıfırlandı / erişilemiyor
http_5xxSunucunuz 5xx döndü
response_too_largeYanıt gövdesi 64 KB sınırını aştı

Tam liste: Hata sınıfları.

Teslimat durumları

DurumAnlamı
pendingSıraya alındı, ilk deneme henüz yapılmadı
retryingBir deneme başarısız oldu, sıradaki bekleniyor
delivered2xx alındı — bitti
exhaustedVazgeçildi: ya kalıcı hata, ya 10 deneme tükendi
cancelledTeslimat iptal edildi — abonelik bu arada duraklatıldı veya silindi

Bekleyen bir teslimat varken aboneliği duraklatırsanız teslimat cancelled olur; 72 saat sonra sürpriz bir bildirim gitmez.

Teslimat geçmişi

Panelde abonelik satırından Teslimat geçmişi açılır. Her teslimat için görürsünüz:

  • HTTP durum kodu ve yanıt süresi
  • Hata sınıfı (timeout, dns, tls, http_5xx …)
  • Kaçıncı deneme olduğu ve toplam deneme sayısı
  • Bir sonraki denemenin zamanı
  • Her denemenin ayrı ayrı ayrıntısı

Bir entegrasyonu hata ayıklarken ilk bakılacak yer burasıdır.

Yanıt gövdesi sınırı

Yanıt gövdeniz okunmaz ama sınırsız da yutulmaz: 64 KB'ı aşan yanıtlar response_too_large hatası verir. Webhook endpoint'inizden büyük gövdeler dönmeyin — boş bir 200 en iyisidir.

Bu sayfada