API hataları iki katmanda okunur: HTTP durum kodu sorunun türünü, yanıt gövdesindeki mesaj ise asıl nedeni söyler. Kodlar sağlayıcıya göre değişir, ancak genel kalıplar benzerdir.
HTTP durum kodları ve anlamları
| Kod | Olası neden | Çözüm |
|---|---|---|
| 400 | Geçersiz parametre, bozuk CSR | İstek gövdesini ve CSR'ı doğrulayın |
| 401 | Geçersiz veya süresi dolmuş anahtar | Yeniden kimlik doğrulayın |
| 403 | Yetki yok, IP kısıtı | Hesap yetkisini ve izinli IP listesini kontrol edin |
| 404 | Sipariş/uç nokta yok | Kimliği ve adresi kontrol edin |
| 409 / 422 | Çakışan veya işlenemeyen istek | Mevcut açık sipariş var mı bakın |
| 429 | İstek sınırı aşıldı | Bekleyip seyrekleştirerek tekrar deneyin |
| 5xx | Sağlayıcı tarafı sorun | Bekleyin, GET isteklerini yeniden deneyin |
Uygulamada sık görülen mesajlar
- Kimlik doğrulama hataları (ör. "auth key is not valid"): anahtar yenilenmeli.
- CSR hataları: CN/SAN uyuşmazlığı, zayıf anahtar boyutu, PEM biçimi bozukluğu.
- Bakiye/limit hataları: Hesap bakiyesini kontrol edin.
- Alan adı reddi: Politika gereği sertifika verilemeyen veya doğrulanamayan alan adı.
Mesaj metinleri sürüme göre değişebilir, bu yüzden hata kodunu string eşleştirmesi yerine mümkünse sağlayıcının verdiği yapılandırılmış kod alanına göre işleyin.
Hata yönetimi deseni
- Kalıcı hatalarda (4xx) yeniden denemeyin; nedeni kullanıcıya anlaşılır iletin.
- Geçici hatalarda (429, 5xx) üstel bekleme ile yeniden deneyin.
- Tam yanıtı iç günlüğe yazın, müşteriye ham hata göstermeyin.
Sertifika kaynaklı bağlantı hatalarında SSL sorun giderici, canlı kontrol için SSL denetleyici kullanılabilir. Çözülmeyen durumlarda Türkçe teknik destek ekibine tam yanıtla birlikte yazın.
Destek talebi açarken
Sağlayıcıya veya destek ekibine başvururken sipariş kimliğini, isteğin zamanını, HTTP durum kodunu ve yanıt gövdesini iletin. Anahtarları ve özel anahtar içeriğini asla paylaşmayın. Bu bilgiler sorunun çok daha hızlı çözülmesini sağlar.