एरर कोड

API त्रुटियाँ और SMTP रिप्लाई कैसे रिपोर्ट होते हैं, और हर प्रकार पर क्या करें।

API एरर फ़ॉर्मैट

API त्रुटियाँ JSON में आती हैं, जिनमें स्थिर कोड और एक संदेश होता है। अपने लॉजिक में कोड से मिलान करें, और संदेश केवल लोगों को दिखाएँ, क्योंकि शब्द बदल सकते हैं।

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

रिट्राई करें या ठीक करें?

त्रुटियाँ दो समूहों में आती हैं। अनुरोध ठीक करें: 429 के अलावा 4xx रिस्पॉन्स का मतलब है कि आपने जो भेजा उसमें गड़बड़ी है, इसलिए रिट्राई उसी तरह विफल होगा। बाद में फिर कोशिश करें: 429 और 5xx अस्थायी हैं, इसलिए एक्सपोनेंशियल बैकऑफ़ और प्रयासों की सीमा के साथ रिट्राई करें।

SMTP रिप्लाई

SMTP रिप्लाई तीन अंकों के कोड से शुरू होते हैं। 2xx का मतलब सफलता है। 4xx का मतलब अस्थायी विफलता है, इसलिए भेजने वाले को बाद में रिट्राई करना चाहिए। 5xx का मतलब स्थायी विफलता है, इसलिए उसी संदेश को उस पते पर दोबारा न भेजें। कई रिप्लाई में 5.1.1 जैसा एन्हांस्ड कोड जुड़ा होता है जो कारण बताता है।

बाउंस के कारण पढ़ना

बाउंस समझने का सबसे तेज़ तरीका एन्हांस्ड कोड हैं। 5.1.1 का मतलब मेलबॉक्स मौजूद नहीं है। 5.2.2 का मतलब मेलबॉक्स भरा है। 5.7.1 का मतलब रिसीविंग सर्वर ने पॉलिसी के आधार पर संदेश अस्वीकार किया, अक्सर प्रमाणीकरण या प्रतिष्ठा के कारण। 4.x.x कोड अस्थायी हैं और उन्हें रिट्राई किया जाएगा।

बाउंस का क्या करें

हार्ड बाउंस होने वाले पते अपनी लिस्ट से हटाएँ, और अपना SPF, DKIM और DMARC सेटअप जाँचकर पॉलिसी अस्वीकृतियों की जाँच करें। बढ़ती बाउंस दर आपकी प्रतिष्ठा को नुकसान पहुँचाती है, इसलिए जल्दी कार्रवाई करें।