Referans
Durum kodları ve hata sınıfları
Hangi yanıtın nasıl yorumlandığı ve teslimat geçmişindeki hata sınıflarının tam listesi.
Yanıtınız nasıl yorumlanır
| Durum kodu | Sonuç | Yeniden denenir mi |
|---|---|---|
200, 201, 202, 204 … (2xx) | Başarılı | — |
301, 302, 307, 308 (3xx) | Kalıcı hata | Hayır |
400 | Kalıcı hata | Hayır |
401 | Kalıcı hata | Hayır |
403 | Kalıcı hata | Hayır |
404 | Kalıcı hata | Hayır |
408 | Geçici hata | Evet |
410 | Kalıcı hata | Hayır |
422 | Kalıcı hata | Hayır |
429 | Geçici hata | Evet |
Diğer 4xx | Geçici hata | Evet |
5xx | Geçici hata | Evet |
| Yanıt yok (ağ hatası) | Geçici hata | Evet |
Kalıcı hatalar yeniden denenmez ve abonelik iki ardışık kalıcı hatadan
sonra failing durumuna düşer. Geçici bir sorunda 503 dönün — 401/403
değil.
Hangi kodu dönmeliyim
| Durumunuz | Dönün |
|---|---|
| Her şey yolunda, işi aldım | 200 |
| İmza doğrulanamadı | 400 |
| Gövde çözümlenemedi | 400 |
| Kuyruğa yazamadım, sonra tekrar dene | 503 |
| Veritabanım şu an erişilemez | 503 |
| Bakımdayım | 503 |
| Bu event tipini tanımıyorum | 200 — hata değil |
Hata sınıfları
Teslimat geçmişinde her başarısız denemenin bir errorClass değeri vardır.
Ağ ve bağlantı
| Sınıf | Anlamı | Bakılacak yer |
|---|---|---|
timeout | 5 saniyede yanıt gelmedi | Yanıt sürenizi ölçün; işi arka plana atın |
dns | Alan adı çözümlenemedi | DNS kaydı yayıldı mı, ad doğru yazıldı mı |
tls | Sertifika geçersiz, süresi dolmuş, kendinden imzalı ya da alan adıyla eşleşmiyor | Tam sertifika zincirini (fullchain) sunun |
connection | Bağlantı reddedildi / sıfırlandı / erişilemiyor | Sunucu ayakta mı, 443 açık mı |
response_too_large | Yanıt gövdeniz 64 KB'ı aştı | Boş 200 dönün |
bad_response | Yanıt çözümlenemedi | Sunucunuz bozuk bir HTTP yanıtı üretiyor |
unknown | Sınıflandırılamayan hata | Teslimat geçmişindeki hata mesajına bakın |
HTTP durum kodu sınıfları
| Sınıf | Anlamı |
|---|---|
http_4xx | Sunucunuz bir 4xx döndü |
http_5xx | Sunucunuz bir 5xx döndü |
http_redirect | Sunucunuz bir 3xx döndü — yönlendirme takip edilmez |
Adres engelleri
Bu hatalarda istek hiç gönderilmez; adres güvenlik kontrolünden geçmemiştir.
| Sınıf | Anlamı |
|---|---|
blocked_scheme_not_allowed | Adres https:// değil |
blocked_credentials_in_url | URL içinde kullanıcı adı/şifre var |
blocked_hostname_missing | URL bir sunucu adı içermiyor |
blocked_loopback_address | localhost, 127.x.x.x veya ::1 |
blocked_private_address | Özel ağ adresi (10.x, 172.16–31.x, 192.168.x), .internal veya .local |
blocked_link_local_address | 169.254.x.x veya fe80::/10 |
blocked_reserved_address | Ayrılmış ya da multicast IP aralığı |
blocked_invalid_url | URL çözümlenemedi |
Tümü kalıcı hata sayılır. Ayrıntı: Güvenlik → Kabul edilmeyen adresler.
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: kalıcı hata ya da 10 deneme tükendi |
cancelled | Abonelik bu arada duraklatıldı veya silindi |
Abonelik durumları
| Durum | Anlamı |
|---|---|
active | Eventler gönderiliyor |
paused | Siz duraklattınız |
failing | Üst üste başarısızlıktan sonra sistem durdurdu |
Eşikler ve geri dönüş: Abonelik durumları.
Hızlı teşhis tablosu
| Belirti | En olası sebep |
|---|---|
http_4xx + 400, hep | İmza doğrulamanız ham gövde kullanmıyor |
http_4xx + 404 | Abonelikteki yol yanlış |
http_4xx + 403 | WAF / güvenlik duvarı engelliyor |
http_redirect + 301 | www yönlendirmesi — nihai adresi yazın |
timeout, ara sıra | Yanıttan önce iş yapıyorsunuz |
timeout, hep | Sunucu ayakta değil ya da yol yanlış portta |
tls | Ara sertifika zinciri eksik |
dns | Alan adı yayılmadı ya da yalnızca iç DNS'te tanımlı |
blocked_* | Adres herkese açık bir HTTPS adresi değil |
Her biri için adım adım çözüm: Hata ayıklama.