सामान्य त्रुटि संदेश
जब कोई अनुरोध विफल होता है, तो Bird एक संरचित त्रुटि लौटाता है, जिसमें मशीन द्वारा पढ़ा जा सकने वाला कोड, एक संदेश, दस्तावेज़ का लिंक और एक अनुरोध ID होती है। प्रोग्राम के लॉजिक में कोड का उपयोग करें। सहायता चाहिए हो, तो Feedback > Contact us चुनें और अनुरोध ID शामिल करें। पूरी सूची के लिए API त्रुटि संदर्भ देखें।
सत्यापन त्रुटियाँ
इनका अर्थ है कि Bird ने आपका अनुरोध समझ लिया, लेकिन उसमें कुछ स्वीकार्य नहीं है। त्रुटि में वह विशिष्ट फ़ील्ड या शर्त बताई जाती है जिसमें गड़बड़ी है।
सभी प्राप्तकर्ता सप्रेस किए गए
इसका अर्थ: आपके भेजे गए संदेश का हर प्राप्तकर्ता आपकी सप्रेशन सूची में है, इसलिए डिलीवर करने के लिए कोई नहीं बचा और भेजना अस्वीकार कर दिया गया।
संभावित कारण: आप ऐसे पतों पर भेज रहे हैं जो पहले हार्ड-बाउंस हुए थे, जिन्होंने शिकायत की थी या सदस्यता छोड़ दी थी। अक्सर इसका मतलब होता है कि आप किसी पुरानी या बिना साफ़ की गई सूची पर दोबारा मेल भेज रहे हैं। यदि केवल कुछ प्राप्तकर्ता सप्रेस किए गए हैं, तो बाकी के लिए संदेश चला जाता है और सप्रेस किए गए प्राप्तकर्ता अस्वीकृत दिखते हैं; यह त्रुटि केवल तब आती है जब सभी सप्रेस किए गए हों।
समाधान: देखें कि कौन से पते सप्रेस किए गए हैं और क्यों, फिर उन्हें अपनी सूची से हटा दें। मेरा ईमेल अस्वीकार क्यों हुआ? बताता है कि सप्रेशन के कारण हुई अस्वीकृतियाँ कैसे दिखती हैं, और सप्रेशन गाइड सूची के प्रबंधन के बारे में बताती है।
ऑनबोर्डिंग प्राप्तकर्ता की अनुमति नहीं
इसका अर्थ: आप Bird के साझा ऑनबोर्डिंग डोमेन से किसी ऐसे व्यक्ति को भेज रहे हैं जो आपके वर्कस्पेस का सत्यापित सदस्य नहीं है।
संभावित कारण: साझा डोमेन केवल सत्यापित वर्कस्पेस सदस्यों और सैंडबॉक्स परीक्षण पतों पर ही ईमेल पहुँचाता है।
समाधान: वास्तविक प्राप्तकर्ताओं को ईमेल भेजने के लिए अपना खुद का भेजने वाला डोमेन सत्यापित करें। इससे यह प्रतिबंध पूरी तरह हट जाता है। सुरक्षा सीमाओं और इनसे बाहर निकलने के तरीके के लिए साझा डोमेन से भेजना देखें।
फ़ील्ड गायब या अमान्य है
इसका अर्थ: कोई आवश्यक फ़ील्ड मौजूद नहीं है, कोई मान अमान्य है, या अनुरोध में असंगत फ़ील्ड एक साथ दिए गए हैं।
संभावित कारण: अनुरोध ऑपरेशन के स्कीमा से मेल नहीं खाता या उसमें असंगत फ़ील्ड एक साथ दिए गए हैं। त्रुटि के विवरण में हर विफल फ़ील्ड की पहचान दी जाती है।
समाधान: त्रुटि का विवरण पढ़ें और उसमें बताए गए फ़ील्ड ठीक करें।
दर-सीमा त्रुटियाँ
इसका अर्थ: अनुरोध ने किसी ऑपरेशन, खाते या भेजने की सीमा को पार कर दिया।
संभावित कारण: अचानक बहुत सारे अनुरोधों ने API दर सीमा पार कर दी, या किसी भेजने ने कोई कोटा पार कर दिया, जैसे साझा ऑनबोर्डिंग डोमेन की प्राप्तकर्ता सीमा।
समाधान: त्रुटि में दिया गया समाधान और Retry-After मान मौजूद हो तो उसका पालन करें। अस्थायी सीमाओं पर बैकऑफ़ के साथ फिर से प्रयास करें। ऑनबोर्डिंग की दैनिक सीमा के लिए UTC दिन के रीसेट होने तक प्रतीक्षा करें या अपना खुद का भेजने वाला डोमेन सत्यापित करें। ईमेल हेल्थ लेबल throttled केवल निदान के लिए है और इससे API दर-सीमा त्रुटि नहीं होती।
प्रमाणीकरण त्रुटियाँ
इसका अर्थ: Bird आपके क्रेडेंशियल स्वीकार नहीं कर सका।
संभावित कारण: इन तीन में से कोई एक, जो मोटे तौर पर कितनी बार होते हैं उसी क्रम में दिए गए हैं:
- गलत, समाप्त या रद्द की गई API कुंजी: कुंजी गलत टाइप हुई है, अधूरी कट गई है, उसकी अवधि समाप्त हो गई है या वह अब सक्रिय नहीं है। सीक्रेट केवल तभी दिखाया जाता है जब कुंजी बनाई या रोटेट की जाती है।
- कुंजी का गलत क्षेत्र में उपयोग: API कुंजियाँ क्षेत्रीय होती हैं, और कोई कुंजी केवल अपने क्षेत्र के सर्वरों पर ही काम करती है। अगर आपकी कुंजी एक क्षेत्र में बनी है और आपका कोड किसी दूसरे क्षेत्र को कॉल करता है, तो ऑथेंटिकेशन विफल हो जाता है। कुंजी के प्रीफ़िक्स से पता चलता है कि वह किस क्षेत्र की है।
- कुंजी मौजूद नहीं: अनुरोध में क्रेडेंशियल शामिल ही नहीं थे। अक्सर इसका कारण कोई ऐसा एनवायरनमेंट वेरिएबल होता है जो विफल हो रहे एनवायरनमेंट में खाली है।
समाधान: अपने डैशबोर्ड में पुष्टि करें कि कुंजी मौजूद और सक्रिय है, आपका कोड उसे भेज रहा है, और आप उसी क्षेत्रीय पते को कॉल कर रहे हैं जो कुंजी से मेल खाता है। संदेह हो तो नई कुंजी बनाएँ और पुरानी की जगह उसका उपयोग करें।
डोमेन सत्यापित नहीं है
इसका अर्थ: भेजने वाले डोमेन का सत्यापन पूरा नहीं हुआ है, इसलिए Bird उससे ईमेल नहीं भेज सकता।
संभावित कारण: DNS रिकॉर्ड मौजूद नहीं हैं, अभी फैल रहे हैं या गलत हैं, या सत्यापन के बाद रिकॉर्ड बदल गए। अपेक्षित समय के लिए डोमेन सत्यापन चेकलिस्ट देखें।
समाधान: बाकी रिकॉर्ड पहचानने के लिए डैशबोर्ड में डोमेन का पेज खोलें। उसे ठीक करने के लिए डोमेन सत्यापन चेकलिस्ट का उपयोग करें। जब तक DNS फैल रहा है, टेस्ट भेजने के लिए साझा ऑनबोर्डिंग डोमेन का उपयोग करें।
किसी भी त्रुटि को कैसे समझें
मशीन-पठनीय त्रुटि कोड के आधार पर मिलान करें, क्योंकि लोगों के लिए लिखे संदेश बदल सकते हैं। अनुरोध ID लॉग करें। अगर आपको सहायता चाहिए, तो Feedback > Contact us चुनें और उसे शामिल करें। त्रुटि-विशिष्ट समाधान के लिए दस्तावेज़ लिंक पर जाएँ।
अगले कदम
- API त्रुटि संदर्भ (पूरी सूची: हर त्रुटि प्रकार, कोड और स्टेटस)
- मेरा ईमेल अस्वीकार क्यों हुआ?: हर प्राप्तकर्ता के स्तर पर होने वाली अस्वीकृतियों के कारण
- ईमेल हेल्थ में Throttled क्यों दिखता है?: निदान के लिए हेल्थ लेबल और उसके पीछे के संकेत
- साझा डोमेन से भेजना: ऑनबोर्डिंग डोमेन पर प्राप्तकर्ताओं और दैनिक सीमा से जुड़ी पाबंदियां
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।