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 sonra | Aradaki bekleme |
|---|---|---|
| 1 | 0 | — |
| 2 | 1 dakika | 1 dakika |
| 3 | 10 dakika | 9 dakika |
| 4 | 1 saat | 50 dakika |
| 5 | 2 saat | 1 saat |
| 6 | 4 saat | 2 saat |
| 7 | 8 saat | 4 saat |
| 8 | 24 saat | 16 saat |
| 9 | 48 saat | 24 saat |
| 10 | 72 saat | 24 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
| Kod | Anlamı | Ne yapmalısınız |
|---|---|---|
3xx | Yönlendirme | Nihai adresi abonelikte doğrudan yazın; yönlendirme takip edilmez |
400 | İstek anlaşılamadı | Gövde çözümlemenizi kontrol edin |
401 | Yetkisiz | Endpoint'iniz hikie'nin gönderemeyeceği bir kimlik doğrulaması bekliyor |
403 | Yasak | Güvenlik duvarı / WAF isteği engelliyor olabilir |
404 | Bulunamadı | Abonelikteki yol yanlış |
410 | Kalıcı olarak gitti | Endpoint kapatılmış |
422 | İşlenemeyen içerik | Doğ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 |
|---|---|
timeout | 5 saniyede yanıt gelmedi |
dns | Alan adı çözümlenemedi |
tls | Sertifika geçersiz, süresi dolmuş veya alan adıyla eşleşmiyor |
connection | Bağlantı reddedildi / sıfırlandı / erişilemiyor |
http_5xx | Sunucunuz 5xx döndü |
response_too_large | Yanıt gövdesi 64 KB sınırını aştı |
Tam liste: Hata sınıfları.
Teslimat durumları
| Durum | Anlamı |
|---|---|
pending | Sıraya alındı, ilk deneme henüz yapılmadı |
retrying | Bir deneme başarısız oldu, sıradaki bekleniyor |
delivered | 2xx alındı — bitti |
exhausted | Vazgeçildi: ya kalıcı hata, ya 10 deneme tükendi |
cancelled | Teslimat 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.