API ve webhook sorunlarını giderin

Önce MailGraf'ın kaydettiği bilgilere bakın. API isteklerinde durum kodunu ve yanıttaki detail değerini not alın. Webhook sorunlarında yeni bir test göndermeden önce Son teslimler bölümündeki başarısız kaydı açın.

API yanıtını inceleyin

İsteği kullanılan anahtar bölümü, kaynak, IP adresi, yanıt kodu ve zamanıyla eşleştirmek için Ayarlar > API > API istek monitörü bölümünü açın. API anahtarının tamamını loglara veya destek mesajlarına kopyalamayın.

401 Unauthorized

İstekte bearer token yoktur ya da API anahtarı geçersiz veya iptal edilmiştir.

• Başlığın Authorization: Bearer mg_live_... biçiminde olduğunu doğrulayın.
• Servis yapılandırmasında fazladan boşluk, tırnak işareti veya eksik değer olup olmadığını kontrol edin.
• Anahtarın tamamını kaybettiyseniz yeni anahtar oluşturun. MailGraf anahtarı yeniden gösteremez.
• Anahtar açığa çıkmış olabilecekse API anahtarı güvenliği adımlarını izleyip anahtarı iptal edin.

Aynı IP adresinden art arda başarısız kimlik doğrulama denemeleri gelirse erişim geçici olarak kilitlenebilir. Yeniden denemeden önce anahtarı düzeltin.

403 Forbidden

MailGraf hesabının şu anda public API erişimi yoktur. İstek gövdesini değiştirmeden önce hesabın planını ve API erişimini kontrol edin.

404 Not Found

İstek yolu yanlış olabilir veya istenen liste, kampanya ya da başka bir kaynak, anahtarın bağlı olduğu hesaba ait değildir. Endpoint yolunu ve kaynak kimliğini birlikte kontrol edin. Bir anahtar başka hesabın verilerini okuyamaz.

422 Unprocessable Content

İstek endpointe ulaşmış ancak bir veya daha fazla değer doğrulamadan geçememiştir. Yanıttaki detail alanını okuyun. Burada tek bir açıklama veya alan bazında sorunların listesi bulunabilir. Aynı gövdeyi yeniden göndermek yerine belirtilen değerleri düzeltin.

429 Too Many Requests

Anahtar istek limitini aşmıştır. Yanıttaki Retry-After başlığını okuyup belirtilen saniye kadar bekleyin. Başarısız isteklerin tümünü aynı anda yeniden göndermek yerine istekleri kuyruğa alın veya zamana yayın.

503 Service Unavailable

MailGraf o anda istek limiti korumasını uygulayamadığı için API güvenli biçimde isteği reddetmiştir. Kısa bir bekleme süresiyle yeniden deneyin. Aynı yanıt devam ederse destek için yanıtın alındığı zamanı ve etkilenen yolu kaydedin.

Webhook endpointini kontrol edin

MailGraf endpointi kaydetmiyorsa URL'nin HTTPS kullandığını ve alan adının internete açık bir IP adresine çözüldüğünü doğrulayın. Localhost, özel ağ adresleri ve ayrılmış adresler kabul edilmez. MailGraf adresi teslim sırasında yeniden kontrol eder. Daha sonra yapılan bir DNS değişikliği de teslimleri durdurabilir.

Kayıtlı bir endpoint için Son teslimler bölümünü açın ve sonuca göre ilerleyin:

• 2xx yanıtı yok: karşı servisin durumunu ve loglarını inceleyin. Buradaki 401 veya 403, MailGraf public API'sinden değil karşı servisten gelir.
• 3xx yanıtı: endpoint URL'sini yönlendirmenin ulaştığı son HTTPS adresiyle değiştirin. MailGraf yönlendirmeleri izlemez.
• Zaman aşımı: uzun sürecek işi kuyruğa alıp yedi saniye içinde 2xx yanıtı verin. Olayı kabul ettikten sonra işlemi tamamlayın.
• İmza eşleşmiyor: endpointin güncel İmza anahtarı değerini kullanın ve JSON verisini ayrıştırmadan önce isteğin ham gövdesini doğrulayın. Webhook imzasını doğrulayın yazısındaki adımları izleyin.

Test olayı yalnızca bir kez gönderilir. Normal olaylar otomatik olarak yeniden denenir. Sorunu giderdikten sonra başarısız teslimde Şimdi tekrar dene seçeneğine tıklayarak yeni bir döngü başlatın.

Yararlı bilgileri kaydedin

Sorun devam ederse yaklaşık UTC zamanını, API yolunu veya webhook olayını, yanıt kodunu ve ilgili monitör ya da teslim kaydını saklayın. API anahtarını veya webhook imza anahtarını paylaşmayın.

Tam referans nerede

Endpoint yolları, istek alanları, yanıt şemaları ve her işlemin döndürebileceği durum kodları için API referansını kullanın.