त्रुटियों का लौटाया गया स्टेटस कोड 400, 401, 402, 403, 404, 429, 500, 502, 503, या 504 होता है। सफलता का लौटाया गया स्टेटस कोड 200 होता है। विवरण के लिए यहाँ देखें।
errorsफ़ील्ड में त्रुटियों की सारणी होती है, प्रति सोशल नेटवर्क एक जिसमें त्रुटि आई।actionलौटाई गई त्रुटि के प्रकार को संदर्भित करता है।- शीर्ष-स्तरीय
statusफ़ील्ड “error” होगा यदि API कॉल विफल हो गई। उदाहरण के लिए, एक /post कॉल के लिए यदि सभी सोशल नेटवर्क पोस्टिंग सफल थीं तोstatusफ़ील्ड “success” होगा, अन्यथा status फ़ील्ड “error” होगा। codeफ़ील्ड में Ayrshare संदर्भ त्रुटि कोड होता है।messageफ़ील्ड त्रुटि के विशिष्ट विवरण हैं।
त्रुटियों को संभालना
आपको किसी भी त्रुटि प्रतिक्रिया को संभालना चाहिए और उचित कार्रवाई करनी चाहिए। एक त्रुटि हुई यदि:- प्रतिक्रिया रिटर्न कोड
200नहीं है - JSON प्रतिक्रिया स्थिति
errorहै
400 Bad Request प्रतिक्रिया कोड के साथ होगी।
400 Bad Request प्रतिक्रिया कोड के साथ है:
मासिक पोस्ट कोटा
Code 106 — मासिक पोस्ट कोटा पार हो गया (HTTP 429) profile ने अपना मासिक पोस्ट कोटा इस्तेमाल कर लिया है।/post नए पोस्ट अनुरोधों के लिए यह लौटाता है, जिनमें पोस्ट शेड्यूल करने वाले अनुरोध भी शामिल हैं। किसी पोस्ट को पाने, हटाने या फिर से आज़माने, या पोस्ट एनालिटिक्स जैसे दूसरे पोस्ट अनुरोध भी कोटा रीसेट होने तक यह लौटाते हैं। कोटा खत्म रहने के दौरान जिन शेड्यूल की गई पोस्ट का समय आता है, वे भी इसी code के साथ विफल होती हैं। यह rate limit नहीं है। कुछ मिनट इंतज़ार करने से मदद नहीं मिलेगी।
आम तौर पर, पूरी प्रतिक्रिया ही error होती है:
errors array में दिखाई देती है। किसी नई पोस्ट के साथ भी ऐसा हो सकता है, अगर उसे भेजे जाने के दौरान कोटा खत्म हो जाए। दोनों जगह code: 106 जाँचें।
Action: User Profile Details से monthlyPostCount और monthlyPostQuota जाँचें। कोटा हर महीने की 1 तारीख (UTC) को रीसेट होता है। अपना प्लान बदलने पर आपके Primary Profile की गिनती तुरंत रीसेट हो जाती है। विफल पोस्ट प्रयास भी गिने जाते हैं, इसलिए बार-बार विफल हो रही पोस्ट के अपने आप होने वाले retries बंद करें। विवरण के लिए मैं कितनी पोस्ट और API कॉल कर सकता हूँ? देखें।
डुप्लिकेट और समान कंटेंट की त्रुटियाँ
किसी पोस्ट के सोशल नेटवर्क तक पहुँचने से पहले, Ayrshare उसकी तुलना आपकी अन्य पोस्ट्स से करता है और समान या लगभग समान कंटेंट को कोड137 के साथ अस्वीकार कर देता है। यह Ayrshare की अपनी जाँच है, इसलिए पोस्ट तब भी अस्वीकार हो सकती है जब नेटवर्क उसे स्वीकार कर लेता। यह जाँच हर platform पर लागू नहीं होती — नीचे दिए गए अपवाद देखें।
scheduleDate पर केंद्रित 48-घंटे की window के विरुद्ध की जाती है — 24 घंटे पहले से 24 घंटे बाद तक। चूँकि यह window पीछे के साथ-साथ आगे भी देखती है, इसलिए किसी पोस्ट को उसके बाद schedule की गई पोस्ट के कारण भी अस्वीकार किया जा सकता है, केवल पहले वाली के कारण नहीं।
तुलना किसके साथ होती है।
- मिलान प्रति user profile और प्रति platform होता है। वही text X/Twitter और LinkedIn दोनों पर भेजना डुप्लिकेट नहीं माना जाता, और दो अलग-अलग user profiles आपस में टकराते नहीं हैं।
- X/Twitter अपवाद है, लेकिन केवल exact duplicates के लिए: बिल्कुल समान post की जाँच भी उसी account के सभी user profiles में की जाती है, क्योंकि X कई handles पर एक ही कंटेंट की अनुमति नहीं देता। लगभग-समान (similarity) मिलान सिर्फ़ उसी एक user profile तक सीमित रहता है जिससे post किया गया था।
- Pinterest, Reddit और Telegram पर डुप्लिकेट जाँच लागू नहीं होती।
Instagram-विशिष्ट त्रुटि कोड
निम्नलिखित त्रुटि कोड Instagram पोस्टिंग विफलताओं के बारे में विशिष्ट विवरण प्रदान करते हैं, जहाँ संभव हो वहाँ सामान्य त्रुटि 138 को प्रतिस्थापित करते हैं। Code 435 — Instagram दर सीमा (HTTP 429) Instagram professional (Business / Creator) खाते Meta के Content Publishing API पर 50-पोस्ट रोलिंग 24-घंटे की सीमा के अधीन हैं (व्यक्तिगत खाते API के माध्यम से बिल्कुल भी प्रकाशित नहीं कर सकते और इसलिए कभी भी इस सीमा तक नहीं पहुँचते)। जब सीमा पार हो जाती है, तो Meta एक दर-सीमा त्रुटि लौटाता है। Ayrsharecode: 435 को तब भी सामने लाता है जब Meta का publish endpoint सीधे HTTP 429 लौटाता है या जब अंतर्निहित त्रुटि सबकोड (1390008) पोस्ट / टिप्पणी थ्रॉटल इंगित करता है।
Retry-After हैडर प्रदान करता है, तो मान (सेकंडों में) details फ़ील्ड पर पास किया जाता है — पुनः सबमिट करने से पहले कम से कम उतनी देर प्रतीक्षा करें।
Code 436 — Instagram मीडिया प्रोसेसिंग टाइमआउट (HTTP 400)
Instagram को अपलोड किए गए मीडिया को संसाधित करने में बहुत अधिक समय लगा। यह बड़ी वीडियो फ़ाइलों के साथ या Meta के सर्वर पर उच्च लोड की अवधि के दौरान हो सकता है।
instagramOptions.trialParams एक /post अनुरोध पर प्रदान किया जाता है लेकिन graduationStrategy गुम है, null, या एक खाली स्ट्रिंग है। Trial reels के लिए एक स्पष्ट graduation strategy की आवश्यकता होती है — Trial Reels देखें।
instagramOptions.trialParams.graduationStrategy को "MANUAL" या "SS_PERFORMANCE" में से एक पर सेट करें और पुनः प्रयास करें, या यदि आपका ट्रायल reel प्रकाशित करने का इरादा नहीं था तो trialParams हटाएँ।
Code 448 — Instagram Trial Reels: Invalid graduationStrategy (HTTP 400)
तब लौटाया जाता है जब graduationStrategy मौजूद है लेकिन बिल्कुल "MANUAL" या "SS_PERFORMANCE" नहीं है। जाँच case-sensitive है — "manual" या "ss_performance" जैसे मान अस्वीकार कर दिए जाते हैं। डिबगिंग में सहायता के लिए details फ़ील्ड अस्वीकृत इनपुट को (64 वर्णों तक काटकर) प्रतिध्वनित करती है।
graduationStrategy को बिल्कुल "MANUAL" या "SS_PERFORMANCE" (अपरकेस, स्ट्रिंग प्रकार) के रूप में भेजें।
Code 449 — Instagram Trial Reels: असंगत मीडिया (HTTP 400)
तब लौटाया जाता है जब मीडिया या पोस्ट आकार trial reel के लिए योग्य नहीं है। Trial reels एकल .mp4 या .mov वीडियो होने चाहिए — carousels (एक से अधिक URL), stories (instagramOptions.stories: true), और गैर-वीडियो एक्सटेंशन सभी अस्वीकार कर दिए जाते हैं। details फ़ील्ड यह स्पष्ट करती है कि कौन सा उप-केस फ़ायर हुआ।
stories: true फ़्लैग के एक एकल .mp4 या .mov वीडियो URL सबमिट करें। अतिरिक्त mediaUrls प्रविष्टियाँ हटाएँ, या यदि आपका इरादा नियमित carousel/story पोस्ट था तो trialParams हटाएँ।
Code 258 — Instagram Account-State त्रुटि (HTTP 400)
आधार संदेश “Error with Instagram.” के साथ एक सामान्य Instagram account-state विफलता। यह तब सामने आती है जब Meta पोस्ट की सामग्री के बजाय कनेक्ट किए गए Instagram खाते की स्थिति के कारण अनुरोध को अस्वीकार करता है।
error_subcode 2207085 (“Generic Internal Error”) है, तो यह Meta की ओर की एक अस्थायी विफलता है। Ayrshare त्रुटि लौटाने से पहले अधिकतम लगभग 50 सेकंड तक स्वचालित रूप से पोस्ट का पुनः प्रयास करता है, और प्रतिक्रिया retryAvailable: true सेट करती है। यह relink: true सेट नहीं करती — रिलिंक करने से यह स्थिति ठीक नहीं होती। जब Meta fbtrace_id देता है, तो वह details में लौटाया जाता है:
2207085 उप-केस के लिए, कुछ मिनट बाद पोस्ट का पुनः प्रयास करें — यह Meta की ओर की स्थिति है जो आमतौर पर स्वयं ठीक हो जाती है, और रिलिंक करने से यह ठीक नहीं होती। केवल यदि त्रुटि 24-48 घंटे से अधिक बनी रहे, तो उपयोगकर्ता को Social Accounts में अपने Instagram खाते को अनलिंक और रिलिंक करने के लिए प्रेरित करें, सभी अनुरोधित अनुमतियाँ प्रदान करें, या details में दिए गए fbtrace_id के साथ Meta सपोर्ट से संपर्क करें। अन्य account-state त्रुटियों के लिए, सत्यापित करें कि Instagram खाता Meta पर अच्छी स्थिति में है और पुनः प्रयास करें।
Retry उपलब्ध
कभी-कभी सोशल नेटवर्क में एक अपुनरारंभ्य त्रुटि होती है, जैसे कि उनके सर्वर में समस्याएँ हैं, और कॉल कई पुनः प्रयासों के बाद भी अंततः विफल हो जाती है। उन मामलों में, हमारी प्रणाली निर्धारित करेगी कि क्या त्रुटि पुनः प्रयास योग्य है और यदि हाँ, तोretryAvailable फ़ील्ड true होगी।
Instagram Reels Audio त्रुटियाँ
ये कोडinstagramOptions.audioConfiguration के साथ किसी Instagram Reel में music अटैच करने, और audio खोज व audio लुकअप एंडपॉइंट को कवर करते हैं।
Code 518
errors[] पर नहीं, postIds[].warnings[] पर आता है। Instagram प्रति Reel एक track की अनुमति देता है, इसलिए जब audioConfiguration और audioName दोनों भेजे जाते हैं, तो audioConfiguration जीतता है और audioName हटा दिया जाता है। प्रतिक्रिया फिर भी HTTP 200 के साथ status: "success" होती है — 518 को informational मानें और इस पर विफल न हों। चेतावनी top level के बजाय उस platform की postIds entry पर nested होती है, और feature: "audioName" ले जाती है।Volume validation समर्पित कोड के बजाय सामान्य
101 रिपोर्ट करता है। audioVolume और videoVolume 0 से 100 तक के integers होने चाहिए। कोई decimal, "80" जैसी numeric string, सीमा से बाहर की संख्या, या स्पष्ट null — Instagram को कॉल किए जाने से पहले ही, details पर उल्लंघित सीमा के नाम के साथ code: 101 लौटाता है। null भेजने के बजाय फ़ील्ड को छोड़ दें।Automation Private-Reply (Comment DM) त्रुटियाँ
ये कोड टिप्पणी-ट्रिगर्ड automations (comment_keyword) पर तब सामने आते हैं जब DM ले जाने वाला private reply नहीं भेजा जा सकता। वे गतिविधि रो पर status: "failed" के रूप में दिखाई देते हैं, कारण actionResults[].errorDetails पर होता है।
इनमें से किसी का भी स्वचालित रूप से पुनः प्रयास नहीं किया जाता — Instagram Send API के पास कोई idempotency कुंजी नहीं है, इसलिए स्वचालित पुनः प्रयास DM को दो बार डिलीवर करने का जोखिम उठाता है। हैंडलिंग प्रति कोड भिन्न होती है (नीचे Action देखें): अधिकांश उस विशिष्ट टिप्पणी के लिए स्थायी हैं, 492 के लिए खाते को फिर से जोड़ने की आवश्यकता होती है, और 493 घंटेवार सीमा रीसेट होने पर स्वयं ठीक हो जाता है।
Code 491 कई कारणों को कवर करता है जिनमें Instagram अंतर नहीं करता, और 490 संकीर्ण अपवाद है। Instagram एक साझा त्रुटि लौटाता है जो एक 7 दिनों से अधिक पुरानी टिप्पणी, एक टिप्पणी जिसे पहले से ही एक उत्तर मिल चुका है (एक टिप्पणी पर केवल एक ही private reply कभी अनुमत है), एक हटाई गई टिप्पणी, और एक ऐसा टिप्पणीकर्ता जो मैसेज रिक्वेस्ट को ब्लॉक करता है — सभी
491 रिपोर्ट करते हैं।490 केवल उस संकीर्ण मामले में रिपोर्ट किया जाता है जहाँ Instagram साझा बकेट लौटाने के बजाय टिप्पणी ID को स्पष्ट रूप से अमान्य के रूप में पहचानता है — इसलिए एक हटाई गई टिप्पणी या तो 490 या 491 के रूप में सामने आ सकती है, यह इस पर निर्भर करता है कि Instagram क्या लौटाता है।चूँकि API इन्हें अलग नहीं करता, हमेशा errorDetails पढ़ें: यह Instagram की अपनी शब्दावली ले जाता है, जो आमतौर पर कारण के बारे में विशिष्ट होती है।Code
489 आरक्षित है और वर्तमान में नहीं लौटाया जाता। इसे “इस टिप्पणी पर पहले से ही एक उत्तर है” मामले के लिए रखा गया है, जिसे Instagram वर्तमान में एक विशिष्ट संकेत के रूप में उजागर नहीं करता — यह मामला आज 491 रिपोर्ट करता है। इसे यहाँ केवल इसलिए सूचीबद्ध किया गया है ताकि संख्या का पुन: उपयोग न हो।वास्तव में समाप्त हो चुका या अमान्य कनेक्शन इस रेंज में नहीं है। यदि संग्रहीत Instagram क्रेडेंशियल समाप्त हो चुका है, तो गतिविधि रो
status: "auth_error" है न कि failed, और खाते को फिर से कनेक्ट करना सही समाधान है। 492 के अपवाद के साथ — जो एक अनुपस्थित अनुमति है और खाते को फिर से कनेक्ट करने पर प्रदान की जाती है — ऊपर दिए गए कोड टिप्पणी-स्तरीय स्थितियाँ हैं और इनका अर्थ कभी भी “फिर से लिंक करें” नहीं होता।GET /automations/:id/activity लौटाता है। Instagram का कारण actionResults[].errorDetails पर होता है:
details पर होता है:
errorDetails वही स्ट्रिंग ले जाता है जो लिफ़ाफ़ा details में डालता है।
Action:
- 490, 491, 495 — प्रति-टिप्पणी स्थितियाँ। उन्हें उस विशिष्ट टिप्पणी के लिए पुनर्प्राप्त नहीं किया जा सकता, और कोई पुनः प्रयास मदद नहीं करेगा; ऑटोमेशन अगली नई टिप्पणी पर सामान्य रूप से काम करता है। Instagram के बताए गए कारण के लिए
errorDetailsपढ़ें। - 492 — Instagram खाते को फिर से कनेक्ट करें, सभी अनुरोधित अनुमतियाँ प्रदान करें। यह एक खाता-स्तरीय समाधान है और अन्यथा हर टिप्पणी को प्रभावित करेगा।
- 493 — प्रतीक्षा करने के अलावा किसी कार्रवाई की आवश्यकता नहीं; घंटेवार सीमा स्वयं रीसेट होती है। स्वचालित रूप से पुनः प्रयास नहीं किया जाता, इसलिए उस टिप्पणी के लिए DM नहीं भेजा जाता।
- 494 — आंतरिक मिसकॉन्फ़िगरेशन, ग्राहक-पक्ष की स्थिति नहीं। यदि यह पुनः होता है तो सपोर्ट से संपर्क करें।
sent स्थिति डिलीवरी की गारंटी नहीं देती। ऊपर दी गई विफलताओं से अलग, एक private reply जिसे Instagram स्वीकार करता है (status: "sent") फिर भी चुपचाप छोड़ा जा सकता है जब प्राप्तकर्ता की Instagram Message requests सेटिंग अजनबियों को ब्लॉक करती है — यह बिल्कुल कोई त्रुटि कोड उत्पन्न नहीं करता। देखें Automation DM Sent but Not Delivered।Thread और Media Option त्रुटियाँ
ये कोड तब लौटाए जाते हैं जब कोई option पोस्ट पर लागू नहीं किया जा सकता — अधिकतर किसी X Thread या Threads thread पर, जहाँ आपके भेजे गए options पूरे thread पर लागू होते हैं।182— वीडियो अवधि की आवश्यकता को पूरा नहीं करता। वीडियो नेटवर्क की न्यूनतम अवधि से छोटा या अधिकतम से लंबा है। प्रतिक्रिया में वीडियो की वास्तविक अवधि, लागू किए गए न्यूनतम और अधिकतम के साथ दी जाती है, इसलिए तीनों की तुलना करके पुष्टि करें कि आपने कौन सी सीमा पार की। X पर मानक सीमा 0.5 से 140 सेकंड (2 मिनट 20 सेकंड) है; लंबा वीडियो पोस्ट करने के लिएlongVideo: trueसेट करें, जो X द्वारा long video के लिए अनुमोदित अकाउंट के लिए अधिकतम को 4 घंटे तक बढ़ा देता है। अन्य नेटवर्क की अपनी सीमाएँ हैं — जिस नेटवर्क पर आप पोस्ट कर रहे हैं उसके लिए मीडिया दिशानिर्देश देखें।101— गुम या गलत पैरामीटर। Threads पर यह तब लौटाया जाता है जबallowCountriesऐसे अकाउंट से भेजा जाता है जिसे Meta ने geo restrictions के लिए पात्र नहीं बनाया है। पोस्ट या thread का कोई भी हिस्सा publish नहीं होता। option भेजने से पहले /user परisEligibleForGeoRestrictionsजाँचें।111— X ने पोस्ट अस्वीकार कर दी। यह ऐसी X विफलता के लिए सामान्य कोड है जिसका कोई अधिक विशिष्ट कोड नहीं है, इसलिए प्रतिक्रिया मेंdetailsपढ़ें — इसमें X का अपना संदेश होता है और यही आपको कारण बताता है। एक सामान्य कारण ऐसा option है जिसका उपयोग करने के लिए अकाउंट अधिकृत नहीं है, जैसे X Subscriptions के बिनाsubscribersOnly, या X Premium के बिना एकल पोस्ट परlongPost; उस स्थिति में option हटा दें या अकाउंट की entitlements जाँचें। कनेक्शन विफलताएँ और अन्य X-पक्षीय त्रुटियाँ भी111के रूप में सामने आती हैं, और उनके लिए अपना अनुरोध बदलने के बजाय पुनः प्रयास करना उचित है।ध्यान दें कि thread परlongPost111का कारण नहीं है — वहाँ इसे एक चेतावनी के साथ अनदेखा किया जाता है और thread publish होता है। Long Post देखें।275— पोस्ट thread के रूप में publish करने के लिए बहुत लंबी है। टेक्स्ट को विभाजित करने से अधिकतम 30 पोस्ट्स से अधिक बन गईं। टेक्स्ट छोटा करें या इसे अलग-अलग threads में बाँटें।\n\nके साथ अपने स्वयं के thread breaks जोड़ना यहाँ मदद नहीं करेगा — हर break एक और पोस्ट बनाता है, इसलिए यह गिनती को सीमा से और आगे धकेल सकता है।
ऐसा option जिसका उपयोग आपका अकाउंट नहीं कर सकता, अनदेखा किए जाने के बजाय पूरी पोस्ट को विफल कर
देता है। किसी thread पर इसका अर्थ है कि thread का कोई भी हिस्सा publish नहीं होता — जो हिस्से पहले
ही publish हो चुके थे, उन्हें आपके लिए हटा दिया जाता है। हटाना best effort है: यदि नेटवर्क delete
को अस्वीकार करता है, तो वह हिस्सा published रह सकता है, इसलिए thread जाँचें और जो कुछ बचा रह गया हो
उसे हटा दें। पहले इनमें से कुछ options threads पर चुपचाप हटा दिए जाते थे और thread उनके बिना publish
हो जाता था।
Link Session त्रुटियाँ
कोड 501 से 513 सोशल लिंकिंग के हैं: Link Session बनाएँ से लिंक बनाना, और उसे खोलना। ये"action": "link session" ले जाते हैं। इस पेज के अन्य 500-श्रेणी
कोड असंबंधित हैं — 514 से 518 Instagram Reels audio के हैं।
संख्यात्मक
code पर मिलान करें, message टेक्स्ट पर नहीं, जो बदल सकता है या अनुवादित हो सकता है।
इनमें से कौन से आपका पेज सुन सकता है। origin सेट होने पर, लिंकिंग पॉपअप आपके पेज को
link completion events पोस्ट करता है, और 513 उस
रास्ते connect:error के रूप में आ सकता है। 501, 502 और 503 नहीं आ सकते: मृत लिंक पेज के
यह जान पाने से पहले ही ठुकरा दिया जाता है कि events कहाँ भेजने हैं, इसलिए आपका उपयोगकर्ता कारण
स्क्रीन पर देखता है और विंडो बंद करने पर आपका पेज connect:cancelled सुनता है। उन तीनों को
अलग-अलग पहचानने के लिए Link Session प्राप्त करें को poll करें।
504 से 510 तक POST के ही इनकार हैं और कभी events के रूप में नहीं आते, और 511 व 512
तब उठाए जाते हैं जब सोशल नेटवर्क callback कर रहा होता है, इसलिए वे आपके पेज के बजाय वहीं सामने
आते हैं।
X/Twitter BYO Key त्रुटियाँ
निम्नलिखित त्रुटि कोड X/Twitter BYO (Bring Your Own) key संचालन के लिए विशिष्ट हैं: Code 272 - BYO Twitter पहचान सत्यापित करने में विफल (HTTP 400) Ayrshare आपके BYO consumer keys और लिंक समय पर संग्रहीत OAuth टोकन का उपयोग करके आपकी X/Twitter पहचान की पुष्टि नहीं कर सका। प्रतिक्रिया आकार इस बात पर निर्भर करता है कि किस कॉल ने इसे ट्रिगर किया; दोनों रूप नीचे दिए गए समान तीन उप-मामलों में मैप होते हैं। यह सत्यापित करें कि कौन सा लागू होता है, BYO Developer App के मालिक खाते के साथ x.com में लॉगिन करके। पोस्ट पथ एक न्यूनतम प्रतिक्रिया उत्सर्जित करता है:details फ़ील्ड शामिल कर सकता है:
details X-साइड संकेत को प्रतिबिंबित करता है और नीचे कौन सा उप-केस लागू होता है, इसके लिए सबसे विश्वसनीय एकल संकेत है।
खाता निलंबित। x.com में लॉगिन करने से एक निलंबन सूचना दिखाई देती है। Action: X सपोर्ट से संपर्क करें। पुनः लिंक करने से तब तक पहुँच बहाल नहीं होगी जब तक X खाते को बहाल नहीं करता।
खाता लॉक। x.com में लॉगिन करने से एक अनलॉक चुनौती (CAPTCHA, फ़ोन सत्यापन, आदि) प्रस्तुत होती है। Action: x.com पर अनलॉक चुनौती पूरी करें, फिर अनुरोध का पुनः प्रयास करें। किसी पुनः लिंक की आवश्यकता नहीं है।
पहचान या key बेमेल। आपका X खाता x.com पर अच्छी स्थिति में है, लेकिन आपके BYO consumer keys लिंक समय पर संग्रहीत OAuth टोकन से भिन्न X Developer App से संबंधित हैं। Action: Social Accounts के अंतर्गत X को फिर से लिंक करें और उसी X खाते के साथ अधिकृत करें जो BYO Developer App का मालिक है।
Code 364 — X Rate Limit (HTTP 429)
X ने आपकी BYO keys से किए गए एक अनुरोध को throttle किया। यह Ayrshare का साझा rate-limit कोड है, और अब यह X comments रीड पथ को भी कवर करता है: जब X रीड को rate limit करता है तो Get Comments इसे लौटाता है, जहाँ पहले इसके बजाय एक खाली comment सूची वापस आती थी।
code: 416 लौटाया जाता है, इसलिए 416 केवल टेक्स्ट प्रकाशित करने या एनालिटिक्स प्राप्त करने तक सीमित नहीं है। पोस्ट प्रकाशित होने से पहले ही अपलोड विफल हो जाता है, और इसे दोबारा नहीं आज़माया जाता — जब तक खाते में क्रेडिट न हों, कोई भी पुनःप्रयास सफल नहीं हो सकता।
x-access-level: read भी देख सकते हैं, जो पुष्टि करता है कि आपका Access Token केवल-पढ़ने योग्य अनुमतियों के साथ उत्पन्न किया गया था।
Action: X Developer Console में, अपनी ऐप अनुमतियों को Read and write and Direct message पर अपडेट करें, फिर Keys and tokens के अंतर्गत अपना Access Token पुनः जनरेट करें। नया टोकन अपडेट की गई अनुमतियों को विरासत में लेगा। विवरण के लिए X BYO Key Setup Guide देखें।
Code 419 - BYO क्रेडेंशियल्स गुम (HTTP 400)
X/Twitter संचालन के लिए अनुरोध हैडर में BYO API क्रेडेंशियल्स की आवश्यकता होती है। Ayrshare कोड 419 तब लौटाता है जब दोनों हैडर गुम हों, और तब भी जब जोड़ी में से केवल एक मौजूद हो। message स्ट्रिंग इस बात पर निर्भर करती है कि कौन सा हैडर(हैडर) गुम है।
जब X-Twitter-OAuth1-Api-Key और X-Twitter-OAuth1-Api-Secret दोनों गुम हैं:
X-Twitter-OAuth1-Api-Key और X-Twitter-OAuth1-Api-Secret दोनों भेजें। यदि आप दूसरे के बिना एक प्रदान करते हैं, तो अनुरोध उसी कोड के साथ अस्वीकार कर दिया जाता है। पूर्ण हैडर सूची के लिए X BYO Keys Header Reference देखें।
Code 423 — Legacy X/Twitter OAuth अब समर्थित नहीं (HTTP 403)
तब लौटाया जाता है जब एक X/Twitter अनुरोध legacy (गैर-BYO) OAuth पथ पर निर्भर करता है, जो अब समर्थित नहीं है। X API एक्सेस के लिए अब अनुरोध हैडर के माध्यम से आपके स्वयं के X Developer App क्रेडेंशियल्स की आवश्यकता होती है।
X-Twitter-OAuth1-Api-Key और X-Twitter-OAuth1-Api-Secret हैडर भेजें। पूर्ण सेटअप चरणों के लिए X BYO Key Setup Guide देखें।
Caption Enhancement त्रुटियाँ
Code 441 — Caption Enhancement विफल (HTTP 502) तब लौटाया जाता है जब एक पोस्ट तैयार करते समय एक या अधिक प्लेटफ़ॉर्म के लिए एक caption enhancement (उदाहरण के लिएshortenLinks) विफल हो जाता है। प्रत्येक प्रभावित प्लेटफ़ॉर्म source: "handlePostAdditions" और code: 441 के साथ errors सारणी में दिखाई देता है।
जब केवल कुछ प्लेटफ़ॉर्म विफल होते हैं, तो अन्य प्लेटफ़ॉर्म अभी भी सफलतापूर्वक पोस्ट करते हैं और उनके परिणाम postIds में दिखाई देते हैं। उस स्थिति में शीर्ष-स्तरीय status "error" है लेकिन postIds गैर-खाली है — क्लाइंट को status और errors[] को पूरक के रूप में मानना चाहिए न कि परस्पर अनन्य।
502 के साथ एक शीर्ष-स्तरीय code: 441 होती है और कोई पोस्ट नहीं बनाई जाती है:
- यदि
postIdsगैर-खाली है (कुछ प्लेटफ़ॉर्म सफलतापूर्वक पोस्ट किए गए), तो पूरे प्लेटफ़ॉर्म सेट को पुनः सबमिट न करें — यह सफल प्लेटफ़ॉर्म पर पोस्ट को डुप्लिकेट कर देगा। इसके बजाय, विफल प्लेटफ़ॉर्म की पहचान करने के लिएerrors[]का निरीक्षण करें और केवल उन प्लेटफ़ॉर्म के साथ अनुरोध का पुनः प्रयास करें, या अपने स्वयं के idempotent retry flow पर भरोसा करें। - यदि
postIdsखाली या गुम है (schedule/post समय पर कुल विफलता), तो पूरे अनुरोध को सुरक्षित रूप से पुनः प्रयास करें। - यदि विफलता बनी रहती है, तो enhancement ध्वज (उदाहरण के लिए,
shortenLinksछोड़ें) के बिना पोस्ट सबमिट करें या सपोर्ट से संपर्क करें।
Media Fetch / Crawler Access त्रुटियाँ
Code 499 — Ayrshare Media Probe अस्थायी रूप से अनुपलब्ध (HTTP 503) तब लौटाया जाता है जब Ayrshare अपना pre-post media निरीक्षण पूरा नहीं कर सकता क्योंकि आंतरिक media-probe सेवा तक पहुँच नहीं बन सकी या उसने एक अमान्य प्रतिक्रिया लौटाई। यह एक Ayrshare सेवा विफलता है, इसका यह प्रमाण नहीं कि आपका media URL, CDN, user-agent नियम, याrobots.txt कॉन्फ़िगरेशन गलत है। त्रुटि retryAvailable: true ले जाती है; विफल प्लेटफ़ॉर्म के लिए शीघ्र ही पुनः प्रयास करें। यदि एक multiplatform अनुरोध आंशिक रूप से सफल हुआ, तो डुप्लिकेट पोस्ट से बचने के लिए केवल उन्हीं प्लेटफ़ॉर्म का पुनः प्रयास करें जो errors[] में सूचीबद्ध हैं।
mediaUrls, ऐसा media जिसे पढ़ा नहीं जा सकता, और कुछ नेटवर्क upload/fetch विफलताएँ शामिल हैं। पहले किसी भी लौटाए गए details की जाँच करें। एक access विफलता के लिए, पुष्टि करें कि URL सार्वजनिक रूप से accessible है, publishing के लिए पर्याप्त समय तक वैध रहता है, और remote अनुरोधों को ब्लॉक नहीं करता है। /media/urlExists केवल एक HEAD reachability जाँच करता है; वहाँ एक सफल परिणाम इस बात की गारंटी नहीं देता कि गहरा pre-post media निरीक्षण या किसी सोशल नेटवर्क का crawler फ़ाइल को डाउनलोड और process कर सकता है। जब विशिष्ट विफलता यह हो कि Ayrshare की अपनी probe सेवा अनुपलब्ध है, तो आपको code 164 के बजाय retryable code 499 मिलता है।
Code 440 — सोशल नेटवर्क मीडिया डाउनलोड नहीं कर सका (HTTP 400)
तब लौटाया जाता है जब प्लेटफ़ॉर्म का publishing crawler आपके द्वारा प्रदान किए गए mediaUrl को डाउनलोड नहीं कर सकता — सबसे आम तौर पर क्योंकि robots.txt या एक WAF / bot-fight नियम crawler को अवरुद्ध कर रहा है (उदाहरण के लिए, Meta का facebookexternalhit)। details स्ट्रिंग upstream प्लेटफ़ॉर्म से आती है और अक्सर Meta/Instagram त्रुटि 2207052 टेक्स्ट होती है।
details स्ट्रिंग में आमतौर पर "Restricted by robots.txt" या "HTTP error code 403" होता है। Code 138 का उपयोग aspect-ratio / format मुद्दों और अन्य सामान्य Instagram त्रुटियों के लिए भी किया जाता है, इसलिए media-fetch वेरिएंट details स्ट्रिंग द्वारा पहचाने योग्य है।
mediaUrl के साथ दोनों प्लेटफ़ॉर्म पर प्रकाशित किया जाता है। Threads API विवरण स्ट्रिंग नहीं लौटाता है, इसलिए निदान के लिए आमतौर पर उसी publish में सह-प्रचलित Instagram 440 या 138 की जाँच करना आवश्यक है।
robots.txt स्निपेट्स और एक सत्यापन कमांड शामिल है।
Threads मीडिया तैयार नहीं है
Code 522 — Threads मीडिया प्रकाशित करने के लिए तैयार नहीं है (HTTP 400) जब Ayrshare ने पोस्ट को प्रकाशित करने का प्रयास किया, तब तक Threads ने पोस्ट को तैयार करना पूरा नहीं किया था। Threads किसी पोस्ट को प्रकाशन स्वीकार करने से कुछ सेकंड पहले ही तैयार के रूप में रिपोर्ट कर सकता है। यह त्रुटि लौटाने से पहले Ayrshare किसी Threads पोस्ट के लिए, मल्टी-पार्ट थ्रेड के सभी हिस्सों को मिलाकर, कुल 30 सेकंड तक प्रतीक्षा करता है और पुनः प्रयास करता है, इसलिए ऐसी अधिकांश पोस्ट अब बिना किसी त्रुटि के प्रकाशित हो जाती हैं। यह आमतौर पर Threads की ओर से एक अस्थायी समस्या होती है और इसका कारण आपकी सामग्री नहीं है। Threads टिप्पणियों, उत्तरों और पहली टिप्पणियों को भी समान प्रतीक्षा मिलती है (पहली टिप्पणी को पोस्ट प्रकाशित होने के बाद अपने स्वयं के 30 सेकंड मिलते हैं), लेकिन वे कोड 522 नहीं लौटाते। मल्टी-पार्ट थ्रेड के लिए,code: 522 ऑब्जेक्ट सीधे errors में नहीं होता: यह Threads त्रुटि के posts ऐरे की अंतिम प्रविष्टि होता है, और ऊपर दिया गया HTTP 400 स्टेटस केवल एकल Threads पोस्ट पर लागू होता है। noAutoRetry: true केवल Ayrshare MCP सर्वर को पोस्ट का स्वयं पुनः प्रयास करने से रोकता है; आप फिर भी इसका पुनः प्रयास कर सकते हैं।
postIds जाँचें। यदि कुछ भी प्रकाशित नहीं हुआ है, तो retry post एंडपॉइंट के साथ पोस्ट का पुनः प्रयास करें। यदि उसी पोस्ट में कोई अन्य प्लेटफ़ॉर्म पहले ही प्रकाशित हो चुका है, तो इसके बजाय केवल Threads पर एक नई पोस्ट भेजें: retry post मूल payload को हर प्लेटफ़ॉर्म पर फिर से भेजता है, जिससे सफल प्लेटफ़ॉर्म पर पोस्ट दूसरी बार प्रकाशित हो जाएगी।
मल्टी-पार्ट थ्रेड: खाली postIds यह साबित नहीं करता कि थ्रेड का कोई भी हिस्सा लाइव नहीं है। जब कोई बाद का हिस्सा विफल होता है, तो Ayrshare प्रकाशित हो चुके हिस्सों को हटा देता है, लेकिन यदि हटाना विफल हो जाता है, तो वह हिस्सा Threads पर बना रहता है। किसी मल्टी-पार्ट थ्रेड का पुनः प्रयास करने से पहले, Threads खाते की जाँच करें और जो भी हिस्से अभी भी मौजूद हैं उन्हें हटा दें, अन्यथा पुनः प्रयास उन्हें फिर से पोस्ट कर देगा।
Facebook Analytics दर सीमा
Code 444 — Facebook Page Analytics दर सीमा (HTTP 429) तब लौटाया जाता है जब एक Facebook Page ने analytics endpoint पर Meta की per-Page दर सीमा को पार कर लिया है। अंतर्निहित Meta त्रुटि80001 है (“There have been too many calls to this Page account.”)। Page लिंक रहता है और प्रकाशन काम करता रहता है — केवल उस Page के लिए analytics fan-out थ्रॉटल किया जाता है।
जब /history/facebook या analytics प्रतिक्रिया में एक एकल पोस्ट के लिए थ्रॉटल का पता चलता है, तो प्रत्येक प्रभावित पोस्ट facebook.code पर code: 444 के साथ errCode: 80001 ले जाती है:
Meta पहचान सत्यापन
Code 326 — Meta पहचान सत्यापन आवश्यक (HTTP 403) तब लौटाया जाता है जब अनुरोध स्वीकार करने से पहले Meta को कनेक्ट किए गए खाते के लिए अतिरिक्त पहचान सत्यापन की आवश्यकता होती है। यह Meta प्लेटफ़ॉर्म — Facebook, Instagram, Facebook Groups, Threads, और Messenger पर लागू होता है। खाते को पुनः कनेक्ट करने से यह हल नहीं होगा; सत्यापन Meta की तरफ पूरा किया जाना चाहिए।Facebook Community Standards ब्लॉक
Code 249 — Facebook Community Standards ब्लॉक (HTTP 400) तब लौटाया जाता है जब Facebook अपने Community Standards के तहत किसी पोस्ट को ब्लॉक करता है। ब्लॉक Facebook खाते या Page पर हो सकता है, या स्वयं पोस्ट पर। Facebook दोनों के लिए एक ही अंतर्निहित त्रुटि का उपयोग करता है और यह नहीं बताता कि कौन-सा लागू होता है। व्यवहार में यह सबसे अधिक बार खाते या Page पर लगाया जाता है, इसलिए सामग्री को दोबारा लिखने या फिर से सबमिट करने से अक्सर कोई लाभ नहीं होता। Facebook Account प्रतिबंध (code 476) की तरह, यह Meta की तरफ से लागू की गई कार्रवाई का परिणाम है। यह गैर-पुनःप्रयास योग्य है और इसमें कोईretryAvailable ध्वज नहीं है। पहले उल्लंघन पर खाता Ayrshare से लिंक रहता है और कोई relink आवश्यक नहीं है। relink करने से ब्लॉक नहीं हटता। बार-बार किया गया उल्लंघन अलग है; नीचे देखें।
Facebook API के माध्यम से विशिष्ट कारण नहीं लौटाता है, इसलिए ग्राहक को कारण देखने और अपील करने के लिए सीधे Facebook के Account Status पृष्ठ की जाँच करनी होगी। जब Facebook अपना स्वयं का शब्दशः पाठ प्रदान करता है, तो Ayrshare इसे details फ़ील्ड में सामने लाता है। ब्लॉक का पता चलने पर Ayrshare खाता स्वामी को एक सूचना ईमेल भी भेजता है।
उसी User Profile पर Community Standards का दोबारा उल्लंघन होने पर Facebook खाता Ayrshare से अनलिंक हो जाता है और User Profile निलंबित कर दी जाती है।
message पाठ पर नहीं, बल्कि 249 के संख्यात्मक code मान पर मिलान करें। message की शब्दावली समय के साथ परिष्कृत की जा सकती है, जबकि code स्थिर रहता है।
Action: Facebook में लॉग इन करें, अपनी प्रोफ़ाइल तस्वीर (ऊपरी-दाएँ) पर क्लिक करें, Help अनुभाग खोलें और Account Status चुनें। Facebook का सपोर्ट सहायक वहाँ विशिष्ट कारण सामने लाता है (जो API नहीं लौटाता) और आपको अपील करने देता है। उपयोगकर्ता को खाते को फिर से लिंक करने के लिए न कहें। फिर से लिंक करने से खाता-स्तर या Page-स्तर का ब्लॉक नहीं हटता। पूरी समस्या निवारण गाइड के लिए Facebook या Instagram Account प्रतिबंधित देखें।
Facebook Account प्रतिबंध
Code 476 — Facebook Account प्रतिबंध (HTTP 400) तब लौटाया जाता है जब Facebook पर एक पोस्ट विफल हो जाती है क्योंकि Meta ने खाते पर प्रतिबंध लगाया है (Meta त्रुटि सबकोड2424009 और 1404078, या Meta की प्रतिबंध शब्दावली जब त्रुटि में कोई सबकोड नहीं होता है)। यह एक खाता-स्तर का प्रतिबंध है, न कि क्षणिक प्रकाशन बाधा — यह गैर-पुनःप्रयास योग्य है और इसमें कोई retryAvailable ध्वज नहीं है। उसी पोस्ट को फिर से सबमिट करने से तब तक सफलता नहीं मिलेगी जब तक Meta के साथ प्रतिबंध हल नहीं हो जाता। खाता Ayrshare से लिंक रहता है; कोई relink आवश्यक नहीं है।
Meta API के माध्यम से विशिष्ट प्रतिबंध कारण नहीं लौटाता है, इसलिए ग्राहक को कारण देखने और अपील करने के लिए सीधे Meta के Account Status पृष्ठ की जाँच करनी होगी। जब Meta अपना स्वयं का शब्दशः पाठ प्रदान करता है, तो Ayrshare इसे details फ़ील्ड में सामने लाता है। प्रतिबंध का पता चलने पर Ayrshare खाता स्वामी को एक सूचना ईमेल भी भेजता है।
छवि प्रारूप रूपांतरण त्रुटियाँ
Ayrshare स्वचालित रूप से WebP, HEIC, HEIF, और AVIF छवियों को उन प्लेटफ़ॉर्म पर पोस्ट करने से पहले JPEG में परिवर्तित करता है जो उन्हें स्वीकार नहीं करते (Instagram, LinkedIn, TikTok, Google My Business, Threads, और WebP के लिए Snapchat; HEIC, HEIF, और AVIF के लिए सभी प्लेटफ़ॉर्म)। रूपांतरण भेजने के समय पारदर्शी रूप से चलता है। नीचे दी गई तीन त्रुटियाँ केवल तभी फ़ायर होती हैं जब रूपांतरण पाइपलाइन स्वयं पूरी नहीं हो सकती; यदि स्रोत छवि पहले से ही एक समर्थित प्रारूप में है, तो कोई रूपांतरण प्रयास नहीं किया जाता है और ये कोड सामने नहीं आएंगे। Code 450 — छवि प्रारूप रूपांतरण विफल (HTTP 400) छवि डाउनलोड की गई थी लेकिन JPEG के रूप में पुनः एन्कोड नहीं की जा सकी। सबसे आम कारण एक भ्रष्ट स्रोत फ़ाइल, कंटेनर के अंदर एक अप्रत्याशित आंतरिक प्रारूप, या एक छवि है जो रूपांतरण आकार सीमा से अधिक है।mediaUrl को सीधे ब्राउज़र में खोलें ताकि यह पुष्टि हो सके कि यह रेंडर करता है। यदि हाँ, तो छवि को एक स्वच्छ JPEG या PNG में पुनः निर्यात करें और पोस्ट का पुनः प्रयास करें।
Code 451 — रूपांतरण के लिए छवि डाउनलोड विफल (HTTP 400)
रूपांतरण पाइपलाइन स्रोत छवि नहीं ला सका। सामान्य कारणों में मूल से 4xx/5xx प्रतिक्रिया, एक नेटवर्क टाइमआउट, एक रीडायरेक्ट श्रृंखला जो हॉप सीमा से अधिक है, या एक URL जो गैर-सार्वजनिक पते पर हल करता है (SSRF गार्ड द्वारा अवरुद्ध) शामिल हैं। जब मौजूद हो, details फ़ील्ड अंतर्निहित कारण स्ट्रिंग ले जाती है।
mediaUrl सार्वजनिक रूप से पहुँच योग्य है (कोई auth नहीं, कोई robots.txt ब्लॉक नहीं, HTTPS पर हल होता है)। यदि URL रीडायरेक्ट करता है, तो सुनिश्चित करें कि अंतिम गंतव्य भी सार्वजनिक है और निजी नेटवर्क पर नहीं है।
Code 452 — परिवर्तित छवि अपलोड विफल (HTTP 500)
रूपांतरण सफल हुआ लेकिन Ayrshare परिवर्तित JPEG को अपने अस्थायी संग्रहण bucket पर स्टेज नहीं कर सका। यह Ayrshare की तरफ से एक आंतरिक विफलता है और पुनः प्रयास योग्य है।
mediaUrl और अनुमानित टाइमस्टैम्प के साथ सपोर्ट से संपर्क करें।
YouTube क्षणिक अपलोड त्रुटियाँ
निम्नलिखित त्रुटि कोड YouTube अपलोड विफलताओं के लिए विशिष्ट संकेत प्रदान करते हैं जो आमतौर पर क्षणिक होती हैं और पुनः प्रयास करने के लिए सुरक्षित हैं। दोनों प्रतिक्रियाओं मेंretryAvailable: true शामिल है, इसलिए एकीकरण HTTP स्टेटस कोड के बजाय उस बूलियन पर शाखा कर सकते हैं।
YouTube अपलोड के लिए अधिकांश पूर्व code: 176 प्रतिक्रियाएँ अब 453 (क्षणिक टाइमआउट) या 454 (क्षणिक सेवा अनुपलब्ध) पर रूट होती हैं, दोनों retryAvailable: true के साथ। यदि आपका एकीकरण YouTube अपलोड पुनः प्रयास करने के लिए HTTP 500 पर फ़िल्टर करता है, तो प्रतिक्रिया बॉडी पर retryAvailable फ़ील्ड पर फ़िल्टर करने के लिए स्विच करें।
Code 453 — YouTube अपलोड टाइमआउट (HTTP 504)
तब लौटाया जाता है जब Google का YouTube ingest पाइपलाइन अपलोड स्वीकार करते समय टाइमआउट हो गया। यह आमतौर पर क्षणिक होता है और एक या दो मिनट के भीतर अपने आप हल हो जाता है।
retryAvailable फ़ील्ड पर शाखा करें। आप उसी payload को पुनः सबमिट करने के लिए retry post एंडपॉइंट का उपयोग कर सकते हैं।
Code 454 — YouTube अपलोड सेवा अस्थायी रूप से अनुपलब्ध (HTTP 503)
तब लौटाया जाता है जब YouTube का अपलोड एंडपॉइंट 5xx स्टेटस लौटाता है, या जब YouTube का कनेक्शन socket परत पर रीसेट या टाइमआउट हो गया (ECONNRESET, ETIMEDOUT, ESOCKETTIMEDOUT)। ये स्थितियाँ क्षणिक हैं।
retryAvailable फ़ील्ड पर शाखा करें।
YouTube थंबनेल त्रुटियाँ Code 307
Code307 तब लौटाया जाता है जब एक कस्टम YouTube thumbNail लागू नहीं किया जा सकता। जब वीडियो स्वयं सफलतापूर्वक पोस्ट होता है, तो यह पोस्ट को विफल नहीं करता है — YouTube परिणाम status: "success" रखता है और warnings सारणी (feature: "thumbnail", code: 307) में विफलता को अतिरिक्त रूप से सामने लाता है। पीछे की संगतता के लिए legacy thumbnail सब-ऑब्जेक्ट को बनाए रखा गया है।
सबसे आम कारण एक असत्यापित YouTube चैनल है। जब कोई चैनल फ़ोन सत्यापन पूरा नहीं करता है, तो YouTube एक upstream 403 सामान्य संदेश "The authenticated user doesn't have permissions to upload and set custom video thumbnails" के साथ लौटाता है। वह शब्दांकन एक OAuth समस्या की तरह लगता है, लेकिन व्यवहार में यह लगभग हमेशा एक सत्यापन समस्या है, इसलिए पहले चैनल सत्यापित करें। YouTube खाते को फिर से लिंक करना एक द्वितीयक कारण है।
warnings प्रविष्टि के रूप में सामने आती है (शीर्ष-स्तरीय status "success" रहता है)। यह इस बात की परवाह किए बिना लागू होता है कि समस्या का पता कब चलता है:
- अपलोड से पहले पकड़ा गया। जब पूर्व-प्रकाशन सत्यापन निश्चित रूप से बता सकता है कि थंबनेल अमान्य है (गलत फ़ाइल प्रकार, पुष्ट 2MB से अधिक, या पहुँच योग्य नहीं URL), Ayrshare थंबनेल छोड़ देता है, फिर भी वीडियो प्रकाशित करता है, और
warningsमें सटीक कारण रिपोर्ट करता है — तो आप विफल अपलोड प्रयास से बचते हैं और प्रदाता द्वारा लौटाए जाने वाले से एक स्पष्ट संदेश प्राप्त करते हैं। - अपलोड के बाद पकड़ा गया। जब विफलता केवल तभी पता चलती है जब YouTube अनुरोध को संसाधित करता है (उदाहरण के लिए असत्यापित-चैनल
403, या बड़े आकार की छवि के लिए413), वीडियो पहले से ही लाइव है और विफलता उसीwarningsसारणी में सामने आती है।
status: "success" + warnings उदाहरण जैसी दिखती है।
Action: https://www.youtube.com/verify (फ़ोन सत्यापन) पर अपने YouTube चैनल को सत्यापित करें। यदि आपका चैनल पहले से ही सत्यापित है और थंबनेल अभी भी विफल हो जाते हैं, तो Social Accounts में अपने YouTube खाते को अनलिंक और फिर से लिंक करें और सभी अनुमतियाँ प्रदान करें। पूर्ण समस्या निवारण गाइड के लिए YouTube Thumbnail Not Applied (Unverified Channel) देखें।
Google Business Profile प्राधिकरण त्रुटियाँ
Code 519 — Google Business Profile प्राधिकरण सेवा अस्थायी रूप से अनुपलब्ध (HTTP 503) तब लौटाया जाता है जब Ayrshare Google प्राधिकरण टोकन रीफ़्रेश पूरा नहीं कर सका, क्योंकि Google का टोकन एंडपॉइंट प्रतिक्रिया देने में धीमा था या उसने एक क्षणिक विफलता लौटाई। यह कोड लौटाए जाने से पहले रीफ़्रेश का स्वचालित रूप से पुनः प्रयास किया जाता है, और प्रतिक्रिया मेंretryAvailable: true शामिल है, इसलिए एकीकरण HTTP स्टेटस कोड के बजाय उस बूलियन पर शाखा कर सकते हैं। खाता जुड़ा रहता है — यह Google की प्राधिकरण सेवा पर एक अस्थायी स्थिति है, टूटा हुआ कनेक्शन नहीं।
हर Google Business Profile ऑपरेशन पहले प्राधिकरण को रीफ़्रेश करता है, इसलिए उनमें से कोई भी यह कोड लौटा सकता है — पोस्ट प्रकाशित करना, पोस्ट इतिहास पढ़ना, स्थान डेटा अपडेट करना, जुड़े हुए खाते को प्राप्त करना, समीक्षाएँ सूचीबद्ध करना, और किसी समीक्षा का उत्तर देना।
इन पथों पर अधिकांश पूर्व code: 227 प्रतिक्रियाएँ अब retryAvailable: true के साथ 519 पर रूट होती हैं। Code 227 उपयोगकर्ता से खाते को फिर से कनेक्ट करने के लिए कहता है, जिसने कभी क्षणिक रीफ़्रेश विफलता को हल नहीं किया — प्राधिकरण स्वयं पूरे समय बरकरार था। यदि आपका एकीकरण Google Business Profile को फिर से लिंक करने का संकेत देने के लिए 227 पर फ़िल्टर करता है, तो इसके बजाय प्रतिक्रिया बॉडी पर retryAvailable फ़ील्ड पर शाखा करने और बैकऑफ़ के साथ पुनः प्रयास करने पर स्विच करें।
details वह कारण ले जाता है जो Google ने रिपोर्ट किया, या — जब रीफ़्रेश Google से किसी प्रतिक्रिया बॉडी के बिना स्थानीय रूप से टाइमआउट हो गया — किए गए प्रयासों और बीते समय का सारांश।
Action: एक्सपोनेंशियल बैकऑफ़ के साथ अनुरोध का पुनः प्रयास करें। पुनः प्रयास योग्य विफलताओं का पता लगाने के लिए HTTP स्टेटस के बजाय प्रतिक्रिया बॉडी पर retryAvailable फ़ील्ड पर शाखा करें।
Pinterest AI Disclosure चेतावनी
Code 521 — Pinterest AI Disclosures लागू नहीं हुए (HTTP 200) चेतावनी, त्रुटि नहीं। तब लौटाया जाता है जबpinterestOptions.aiDisclosures अमान्य हो, उदाहरण के लिए कोई अज्ञात मान या गलत casing। REST API के माध्यम से, ऐसा मान जो strings का array नहीं है, वह भी 521 लौटाता है। पिन फिर भी प्रकाशित होता है, लेकिन Ayrshare Pinterest को कोई AI disclosure नहीं भेजता। MCP server और GraphQL API पहले मान के प्रकार (type) की जाँच करते हैं, इसलिए वहाँ गलत रूप वाले मान, जैसे किसी संख्या वाली सूची, पोस्ट करने से पहले ही अस्वीकार कर दिए जाते हैं। चेतावनी Pinterest entry के postIds[].warnings[] पर आती है, errors[] पर नहीं, और feature: "pinterestOptions.aiDisclosures" ले जाती है। स्वीकृत मान AI_MODIFIED और SYNTHETIC_PERFORMER हैं।
Reddit पोस्टिंग त्रुटियाँ
Code 442 — Reddit प्रतिबंधित Subreddit (HTTP 400) तब लौटाया जाता है जब खाते को लक्ष्य subreddit पर पोस्ट करने से प्रतिबंधित कर दिया गया है। यह पुनः प्रयास योग्य नहीं है — यदि पोस्ट को जैसा है वैसा फिर से सबमिट किया जाता है तो सफल नहीं होगा। संदेश में प्रभावित subreddit नाम शामिल है (उदाहरण के लिए,r/news)।
r/news)।
मॉडरेशन त्रुटियाँ
Code 438 — मॉडरेशन इनपुट अस्वीकृत (HTTP 400)POST /validate/moderation द्वारा तब लौटाया जाता है जब AI प्रदाता प्रदान किए गए इनपुट को अस्वीकार करता है — उदाहरण के लिए, एक असमर्थित फ़ाइल प्रकार। यह अनुरोध के साथ एक इनपुट समस्या है, न कि क्षणिक प्रसंस्करण विफलता।
कोड 438 की तुलना कोड 331 से करें। कोड 331 उसी मॉडरेशन परिदृश्य को कवर करता है लेकिन प्रदाता की तरफ एक वास्तविक प्रसंस्करण विफलता का प्रतिनिधित्व करता है (HTTP 500, संदेश “There was an issue with the AI processing. Please try again.”)। कोड 331 एक क्षणिक सर्वर-साइड विफलता है जिसे आप पुनः प्रयास कर सकते हैं, जबकि कोड 438 इंगित करता है कि इनपुट स्वयं अस्वीकार कर दिया गया था और पुनः प्रयास करने से पहले सही किया जाना चाहिए।
LinkedIn Authorization Refresh त्रुटियाँ
कोड 524 — LinkedIn Token Refresh अस्वीकृत (HTTP 500) यह तब लौटाया जाता है जब LinkedIn उपयोगकर्ता के खाते की बजाय एप्लिकेशन के LinkedIn कॉन्फ़िगरेशन में किसी समस्या के कारण authorization को refresh करने से मना कर देता है। उपयोगकर्ता का LinkedIn कनेक्शन अब भी मान्य है, इसलिए फिर से लिंक करने से यह ठीक नहीं होता। रिस्पॉन्स मेंresolution.relink फ़ील्ड शामिल नहीं होता, और इसमें retryAvailable: false होता है क्योंकि दोबारा प्रयास करने से यह ठीक नहीं होता।
कोई भी LinkedIn ऑपरेशन जो पहले authorization को refresh करता है, यह कोड लौटा सकता है, जैसे access token की समय-सीमा समाप्त होने के बाद कोई पोस्ट प्रकाशित करना।
यदि LinkedIn किसी अस्थायी कारण से refresh में लगातार विफल होता है, तो Ayrshare दोबारा प्रयास करता है और फिर इसके बजाय कोड 119 (“There was an issue connecting with LinkedIn. Please try again.”) लौटाता है। कोड 119 के लिए बाद में दोबारा प्रयास करना सुरक्षित है; कोड 524 दोबारा प्रयास करने से ठीक नहीं होता।
LinkedIn Analytics त्रुटियाँ
Code 475 — Analytics के लिए LinkedIn Profile को फिर से लिंक करें (HTTP 403)POST /analytics/post और POST /analytics/social द्वारा एक व्यक्तिगत (member) LinkedIn प्रोफ़ाइल के लिए लौटाया जाता है जो member analytics शिप होने से पहले लिंक किया गया था। इन प्रोफाइल में LinkedIn member analytics scopes (r_member_postAnalytics, r_member_profileAnalytics) की कमी है, इसलिए LinkedIn analytics अनुरोध को अस्वीकार करता है। पोस्टिंग अप्रभावित है।
475 लौटाती रह सकती है।
TikTok टिप्पणी त्रुटियाँ
Code 288 — TikTok टिप्पणी स्थगित / पोस्ट अभी भी संसाधित हो रहा है (HTTP 400) TikTok वीडियो को असिंक्रोनस रूप से संसाधित करता है, इसलिए एक ताज़ी प्रकाशित पोस्ट कीid "pending" होती है जब तक TikTok का post.publish.publicly_available वेबहुक वास्तविक वीडियो id को हल नहीं करता। एक पोस्ट के विरुद्ध एक get-comments, टिप्पणी, या उत्तर अनुरोध जो अभी भी संसाधित हो रहा है (या जिसकी id "failed" है) TikTok को किसी भी कॉल से पहले अस्वीकार कर दिया जाता है और सामान्य विफलता के बजाय कोड 288 लौटाता है।
tikTokPublished Scheduled Action वेबहुक सुनें या /history को तब तक पोल करें जब तक पोस्ट id हल की गई संख्यात्मक वीडियो id न हो। पोस्ट के हल होने पर एक पहली टिप्पणी स्वचालित रूप से पोस्ट होती है, इसलिए इसे पुनः प्रयास करने की आवश्यकता नहीं है। एक "failed" पोस्ट के लिए संदेश इसके बजाय नोट करता है कि वीडियो प्रकाशित होने में विफल रहा और कार्रवाई नहीं चलेगी।
समाप्त हो चुके या अनुपलब्ध Story त्रुटियाँ
Code 485 — Instagram / Facebook Story Comments और Instagram Story Analytics (प्रतिनिधि होने पर HTTP 404) Stories अपनी उपलब्धता विंडो के बाद समाप्त हो सकती हैं या अनुपलब्ध हो सकती हैं। उस विंडो के बाद, comments या insights पुनर्प्राप्त नहीं किए जा सकते। कोड485 की पहचान इस प्रकार करता है:
- get-comments से समाप्त हो चुकी या अनुपलब्ध Instagram और Facebook Story legs; और
POST /analytics/postसे एक समाप्त हो चुकी या अनुपलब्ध Instagram Story leg।
485 के अंतर्गत नहीं आते। क्लाइंट को संख्यात्मक code का मिलान करना चाहिए, न कि सटीक संदेश पाठ का, जो भिन्न हो सकता है या अनुवादित हो सकता है।
एक मल्टीप्लेटफ़ॉर्म रीड पर जहाँ कम से कम एक अन्य प्लेटफ़ॉर्म सफल होता है, विफल leg शीर्ष-स्तरीय errors[] सरणी में दिखाई देती है जबकि स्वस्थ प्लेटफ़ॉर्म सामान्य रूप से लौटते हैं। समग्र प्रतिक्रिया HTTP 200 होती है, शीर्ष-स्तरीय status: "partial" के साथ (comments के लिए मल्टीप्लेटफ़ॉर्म रीड्स और आंशिक सफलता और analytics देखें)।
Get Comments आंशिक-सफलता उदाहरण
Post Analytics आंशिक-सफलता उदाहरण
status: "error" होती है और पूर्ण errors[] सरणी शामिल होती है। प्रतिनिधि कोड 485 HTTP 404 पर मैप होता है; अन्य प्रतिनिधि कोड अपनी स्वयं की HTTP मैपिंग का उपयोग करते हैं।
Action: कोड 485 को इस संकेत के रूप में मानें कि अनुरोधित Story comments या insights पुनर्प्राप्त नहीं किए जा सकते। संदेश पाठ से स्थायी-विफलता, पुनः-प्रयास योग्यता, या अकाउंट-लिंक निष्कर्ष निकालने के बजाय कोड पर मिलान करें।
त्रुटि संदेश अनुवाद
API त्रुटि संदेश प्रतिक्रिया को स्वचालित रूप से आपकी पसंद की भाषा में अनुवादित किया जा सकता है। यह उपयोगी है यदि आप अपने उपयोगकर्ता को उनकी पसंदीदा भाषा में सीधे त्रुटि प्रदर्शित करना चाहते हैं। यदि आप सोशल लिंकिंग पृष्ठ की भाषा चुनना चाहते हैं तो यहाँ देखें। हैडर में शामिल करें:Language_Code उपलब्ध language codes में से एक है।
उदाहरण के लिए, निम्नलिखित त्रुटि को फ़्रेंच में अनुवादित करेगा।