सामान्य त्रुटि संदेश
जब कोई अनुरोध विफल होता है, तो Bird एक संरचित त्रुटि लौटाता है जिसमें एक मशीन-पठनीय कोड, एक संदेश, एक डॉक्यूमेंटेशन लिंक और एक request ID होती है। प्रोग्राम लॉजिक में कोड का उपयोग करें। जब आपको सहायता चाहिए, तो Feedback > Contact us चुनें और request ID शामिल करें। पूरी सूची के लिए API त्रुटि संदर्भ देखें।
वैलिडेशन त्रुटियाँ
इनका मतलब है कि Bird ने आपका अनुरोध समझ लिया लेकिन उसमें कुछ स्वीकार्य नहीं है। त्रुटि में विशिष्ट फ़ील्ड या समस्याग्रस्त शर्त बताई जाती है।
सभी प्राप्तकर्ता दबाए गए
इसका अर्थ: आपके भेजे जाने वाले संदेश का हर प्राप्तकर्ता आपकी suppression सूची में है, इसलिए डिलीवर करने के लिए कुछ बचा नहीं और भेजना अस्वीकार कर दिया गया।
संभावित कारण: आप उन पतों पर भेज रहे हैं जो पहले hard-bounce हुए, शिकायत की गई, या अनसब्सक्राइब हुए। अक्सर यह पुरानी या बिना साफ़ की गई सूची को दोबारा मेल करने का संकेत है। अगर केवल कुछ प्राप्तकर्ता suppressed हैं, तो बाकी के लिए भेजना सफल होता है और suppressed वाले rejected दिखते हैं; यह त्रुटि तभी आती है जब सभी suppressed हों।
समाधान: जाँचें कि कौन से पते suppressed हैं और क्यों, और उन्हें अपनी सूची से हटाएँ। मेरा ईमेल क्यों अस्वीकार हुआ? बताता है कि suppression अस्वीकृतियाँ कैसे दिखती हैं, और suppressions गाइड सूची प्रबंधन को कवर करती है।
ऑनबोर्डिंग प्राप्तकर्ता अनुमत नहीं
इसका अर्थ: आप Bird के साझा ऑनबोर्डिंग डोमेन से किसी ऐसे व्यक्ति को भेज रहे हैं जो आपके वर्कस्पेस का सत्यापित सदस्य नहीं है।
संभावित कारण: साझा डोमेन केवल सत्यापित वर्कस्पेस सदस्यों और sandbox टेस्ट पतों पर ही डिलीवर करता है।
समाधान: वास्तविक प्राप्तकर्ताओं को ईमेल करने के लिए अपना खुद का भेजने वाला डोमेन सत्यापित करें, जिससे यह प्रतिबंध पूरी तरह हट जाता है। सुरक्षा सीमाओं और समाधान के लिए साझा डोमेन से भेजना देखें।
अनुपस्थित या अमान्य फ़ील्ड
इसका अर्थ: कोई आवश्यक फ़ील्ड अनुपस्थित है, कोई मान अमान्य है, या अनुरोध में असंगत फ़ील्ड एक साथ हैं।
संभावित कारण: अनुरोध ऑपरेशन के स्कीमा से मेल नहीं खाता या असंगत फ़ील्ड को जोड़ता है। त्रुटि विवरण हर विफल फ़ील्ड की पहचान करता है।
समाधान: त्रुटि विवरण पढ़ें और नामित फ़ील्ड ठीक करें।
दर-सीमा त्रुटियाँ
इसका अर्थ: अनुरोध ने किसी ऑपरेशन, खाते या भेजने की सीमा को पार कर दिया।
संभावित कारण: किसी बर्स्ट ने API दर सीमा पार कर दी, या किसी भेजे ने कोई कोटा पार कर दिया जैसे साझा ऑनबोर्डिंग डोमेन की प्राप्तकर्ता सीमा।
समाधान: त्रुटि के remediation और Retry-After मान का पालन करें जब वह मौजूद हो। अस्थायी सीमाओं के लिए backoff के साथ फिर से प्रयास करें। ऑनबोर्डिंग दैनिक सीमा के लिए UTC-दिन रीसेट की प्रतीक्षा करें या अपना भेजने वाला डोमेन सत्यापित करें। ईमेल-हेल्थ लेबल throttled डायग्नोस्टिक है और API दर-सीमा त्रुटि उत्पन्न नहीं करता।
प्रमाणीकरण त्रुटियाँ
इसका अर्थ: Bird आपके क्रेडेंशियल स्वीकार नहीं कर पाया।
संभावित कारण: मोटे तौर पर बारंबारता के क्रम में तीन में से एक:
- गलत, समाप्त, या निरस्त API key: key गलत टाइप है, कटी हुई है, समाप्त हो चुकी है, या अब सक्रिय नहीं है। secret केवल key बनाते या रोटेट करते समय दिखाया जाता है।
- Key गलत रीजन के विरुद्ध उपयोग की गई: API keys रीजनल हैं, और key केवल अपने रीजन के सर्वर पर ही काम करती है। अगर आपकी key एक रीजन में बनाई गई और आपका कोड दूसरे को कॉल करता है, तो प्रमाणीकरण विफल होता है। key prefix बताता है कि वह किस रीजन की है।
- Key अनुपस्थित: अनुरोध में क्रेडेंशियल शामिल ही नहीं थे। अक्सर कोई environment variable जो विफल हो रहे environment में खाली है।
समाधान: पुष्टि करें कि key आपके dashboard में मौजूद और सक्रिय है, कि आपका कोड उसे भेज रहा है, और कि आप key से मेल खाने वाले रीजनल पते को कॉल कर रहे हैं। संदेह होने पर एक नई key बनाएँ और उसे लगाएँ।
डोमेन सत्यापित नहीं
इसका अर्थ: भेजने वाले डोमेन ने सत्यापन पूरा नहीं किया है, इसलिए Bird उससे भेज नहीं सकता।
संभावित कारण: DNS रिकॉर्ड अनुपस्थित हैं, अभी प्रसारित हो रहे हैं, या गलत हैं, या सत्यापन के बाद रिकॉर्ड बदल गए। अपेक्षित समय के लिए डोमेन सत्यापन चेकलिस्ट देखें।
समाधान: बकाया रिकॉर्ड पहचानने के लिए dashboard में डोमेन का पेज खोलें। इसे ठीक करने के लिए डोमेन सत्यापन चेकलिस्ट का उपयोग करें। जब तक DNS प्रसारित हो रहा हो, टेस्ट भेजने के लिए साझा ऑनबोर्डिंग डोमेन का उपयोग करें।
किसी भी त्रुटि को पढ़ना
मशीन-पठनीय त्रुटि कोड पर मिलान करें क्योंकि मानव-पठनीय संदेश बदल सकते हैं। request ID लॉग करें। अगर आपको सहायता चाहिए, तो Feedback > Contact us चुनें और उसे शामिल करें। त्रुटि-विशिष्ट समाधान के लिए डॉक्यूमेंटेशन लिंक का पालन करें।
अगले कदम
- API त्रुटि संदर्भ (पूरी सूची: हर त्रुटि प्रकार, कोड और स्टेटस)
- मेरा ईमेल क्यों अस्वीकार हुआ?: प्रति-प्राप्तकर्ता अस्वीकृतियों के कारण
- ईमेल हेल्थ Throttled क्यों दिखाता है?: डायग्नोस्टिक हेल्थ लेबल और उसके पीछे के संकेत
- साझा डोमेन से भेजना: ऑनबोर्डिंग डोमेन की प्राप्तकर्ता और दैनिक-सीमा सुरक्षा सीमाएँ
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।
गाइड देखेंWhat happens when someone opts outकॉन्सेप्ट समझेंWhat is one-click unsubscribe, and how do I implement List-Unsubscribe?क्षमता जानेंEmail opt-outsलर्निंग पाथ फ़ॉलो करेंOperate messaging reliably
इम्प्लीमेंटेशन ब्रीफ़ पाएँ