मुख्य सामग्री पर जाएं
REST API लागू होने पर त्रुटियों की सूची के साथ प्रतिक्रिया शामिल करेगा।
त्रुटियों का लौटाया गया स्टेटस कोड 400, 401, 402, 403, 404, 429, 500, 502, 503, या 504 होता है। सफलता का लौटाया गया स्टेटस कोड 200 होता है। विवरण के लिए यहाँ देखें।
प्रत्येक API कॉल विशिष्ट अनुरोध और सोशल नेटवर्क पर आई किसी भी समस्या के आधार पर विभिन्न त्रुटियाँ लौटा सकती है। त्रुटि प्रतिक्रिया में API कॉल के दौरान क्या गलत हुआ, इसके बारे में विवरण शामिल होंगे। उदाहरण के लिए, एक पोस्ट जिसे Twitter और Facebook द्वारा डुप्लिकेट माना जाता है, निम्नलिखित प्रतिक्रिया लौटाएगी।
कृपया ध्यान दें:
  • errors फ़ील्ड में त्रुटियों की सारणी होती है, प्रति सोशल नेटवर्क एक जिसमें त्रुटि आई।
  • action लौटाई गई त्रुटि के प्रकार को संदर्भित करता है।
  • शीर्ष-स्तरीय status फ़ील्ड “error” होगा यदि API कॉल विफल हो गई। उदाहरण के लिए, एक /post कॉल के लिए यदि सभी सोशल नेटवर्क पोस्टिंग सफल थीं तो status फ़ील्ड “success” होगा, अन्यथा status फ़ील्ड “error” होगा।
  • code फ़ील्ड में Ayrshare संदर्भ त्रुटि कोड होता है।
  • message फ़ील्ड त्रुटि के विशिष्ट विवरण हैं।

त्रुटियों को संभालना

आपको किसी भी त्रुटि प्रतिक्रिया को संभालना चाहिए और उचित कार्रवाई करनी चाहिए। एक त्रुटि हुई यदि:
  • प्रतिक्रिया रिटर्न कोड 200 नहीं है
  • JSON प्रतिक्रिया स्थिति error है
उदाहरण के लिए, यदि Facebook लिंक आपके उपयोगकर्ता द्वारा हटा दिया गया - उन्होंने अपना पासवर्ड बदल दिया या Ayrshare की पहुँच हटा दी - तो पोस्ट करते समय निम्नलिखित प्रतिक्रिया 400 Bad Request प्रतिक्रिया कोड के साथ होगी।
एक कार्रवाई अपने डैशबोर्ड, टेक्स्ट या ईमेल के माध्यम से अपने उपयोगकर्ता को सूचित करना हो सकती है। एक और उदाहरण है यदि पोस्ट की गई Instagram छवि गलत आयाम या अनुपात के साथ 400 Bad Request प्रतिक्रिया कोड के साथ है:
एक कार्रवाई सही अनुपात के साथ छवियों को फिर से भेजना हो सकती है।

Instagram-विशिष्ट त्रुटि कोड

निम्नलिखित त्रुटि कोड Instagram पोस्टिंग विफलताओं के बारे में विशिष्ट विवरण प्रदान करते हैं, जहाँ संभव हो वहाँ सामान्य त्रुटि 138 को प्रतिस्थापित करते हैं। Code 435 — Instagram दर सीमा (HTTP 429) Instagram professional (Business / Creator) खाते Meta के Content Publishing API पर 50-पोस्ट रोलिंग 24-घंटे की सीमा के अधीन हैं (व्यक्तिगत खाते API के माध्यम से बिल्कुल भी प्रकाशित नहीं कर सकते और इसलिए कभी भी इस सीमा तक नहीं पहुँचते)। जब सीमा पार हो जाती है, तो Meta एक दर-सीमा त्रुटि लौटाता है। Ayrshare code: 435 को तब भी सामने लाता है जब Meta का publish endpoint सीधे HTTP 429 लौटाता है या जब अंतर्निहित त्रुटि सबकोड (1390008) पोस्ट / टिप्पणी थ्रॉटल इंगित करता है।
Action: पुनः प्रयास करने से पहले दर सीमा विंडो के रीसेट होने की प्रतीक्षा करें। जब Meta एक Retry-After हैडर प्रदान करता है, तो मान (सेकंडों में) details फ़ील्ड पर पास किया जाता है — पुनः सबमिट करने से पहले कम से कम उतनी देर प्रतीक्षा करें। Code 436 — Instagram मीडिया प्रोसेसिंग टाइमआउट (HTTP 400) Instagram को अपलोड किए गए मीडिया को संसाधित करने में बहुत अधिक समय लगा। यह बड़ी वीडियो फ़ाइलों के साथ या Meta के सर्वर पर उच्च लोड की अवधि के दौरान हो सकता है।
Action: retry post एंडपॉइंट का उपयोग करके पोस्ट का पुनः प्रयास करें। यदि समस्या बनी रहती है, तो मीडिया फ़ाइल आकार को कम करने का प्रयास करें। Code 447 — Instagram Trial Reels: Missing graduationStrategy (HTTP 400) तब लौटाया जाता है जब instagramOptions.trialParams एक /post अनुरोध पर प्रदान किया जाता है लेकिन graduationStrategy गुम है, null, या एक खाली स्ट्रिंग है। Trial reels के लिए एक स्पष्ट graduation strategy की आवश्यकता होती है — Trial Reels देखें।
Action: 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 वर्णों तक काटकर) प्रतिध्वनित करती है।
Action: graduationStrategy को बिल्कुल "MANUAL" या "SS_PERFORMANCE" (अपरकेस, स्ट्रिंग प्रकार) के रूप में भेजें। Code 449 — Instagram Trial Reels: असंगत मीडिया (HTTP 400) तब लौटाया जाता है जब मीडिया या पोस्ट आकार trial reel के लिए योग्य नहीं है। Trial reels एकल .mp4 या .mov वीडियो होने चाहिए — carousels (एक से अधिक URL), stories (instagramOptions.stories: true), और गैर-वीडियो एक्सटेंशन सभी अस्वीकार कर दिए जाते हैं। details फ़ील्ड यह स्पष्ट करती है कि कौन सा उप-केस फ़ायर हुआ।
Action: बिना stories: true फ़्लैग के एक एकल .mp4 या .mov वीडियो URL सबमिट करें। अतिरिक्त mediaUrls प्रविष्टियाँ हटाएँ, या यदि आपका इरादा नियमित carousel/story पोस्ट था तो trialParams हटाएँ। Code 258 — Instagram Account-State त्रुटि (HTTP 400) आधार संदेश “Error with Instagram.” के साथ एक सामान्य Instagram account-state विफलता। यह तब सामने आती है जब Meta पोस्ट की सामग्री के बजाय कनेक्ट किए गए Instagram खाते की स्थिति के कारण अनुरोध को अस्वीकार करता है।
जब अंतर्निहित Meta error_subcode 2207085 है, तो प्रतिक्रिया अतिरिक्त रूप से relink: true और retryAvailable: true सेट करती है, और संदेश उपयोगकर्ता को Instagram खाते को अनलिंक और रिलिंक करने का निर्देश देता है, सभी अनुमतियों को प्रदान करता है:
Action: 2207085 उप-केस के लिए, उपयोगकर्ता को Social Accounts में अपने Instagram खाते को अनलिंक और रिलिंक करने के लिए प्रेरित करें, सभी अनुरोधित अनुमतियाँ प्रदान करें, फिर पोस्ट का पुनः प्रयास करें। अन्य account-state त्रुटियों के लिए, सत्यापित करें कि Instagram खाता Meta पर अच्छी स्थिति में है और पुनः प्रयास करें।

Retry उपलब्ध

कभी-कभी सोशल नेटवर्क में एक अपुनरारंभ्य त्रुटि होती है, जैसे कि उनके सर्वर में समस्याएँ हैं, और कॉल कई पुनः प्रयासों के बाद भी अंततः विफल हो जाती है। उन मामलों में, हमारी प्रणाली निर्धारित करेगी कि क्या त्रुटि पुनः प्रयास योग्य है और यदि हाँ, तो retryAvailable फ़ील्ड true होगी।
फिर आप उसी payload के साथ कॉल का पुनः प्रयास कर सकते हैं। यदि यह एक पोस्ट है तो आप retry post एंडपॉइंट का उपयोग कर सकते हैं।

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 में लॉगिन करके। पोस्ट पथ एक न्यूनतम प्रतिक्रिया उत्सर्जित करता है:
एनालिटिक्स पथ एक लंबा, स्व-दस्तावेजीकरण संदेश उत्सर्जित करता है और X की कच्ची त्रुटि स्ट्रिंग ले जाने वाला 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 416 — X Credits समाप्त (HTTP 402) आपके X Developer खाते में कोई API क्रेडिट लोड नहीं है। सभी X API कॉलों के लिए क्रेडिट की आवश्यकता होती है।
Action: console.x.com → Billing → Credits पर जाएँ और क्रेडिट खरीदें। यहाँ तक कि $5 भी सैकड़ों API कॉलों के लिए पर्याप्त है। Code 417 — OAuth 1.0a App अनुमतियाँ (HTTP 403) आपके X Access Token के पास अनुरोधित संचालन के लिए सही अनुमतियाँ नहीं हैं।
आप प्रतिक्रिया हैडर 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 दोनों गुम हैं:
जब जोड़ी में से केवल एक मौजूद है (उदाहरण के लिए, secret के बिना key):
Action: प्रत्येक X-बाउंड अनुरोध पर 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 क्रेडेंशियल्स की आवश्यकता होती है।
Action: एक X Developer App कॉन्फ़िगर करें और प्रत्येक X-बाउंड अनुरोध पर 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[] को पूरक के रूप में मानना चाहिए न कि परस्पर अनन्य।
यदि सभी प्लेटफ़ॉर्म enhancement में विफल हो जाते हैं, तो प्रतिक्रिया HTTP 502 के साथ एक शीर्ष-स्तरीय code: 441 होती है और कोई पोस्ट नहीं बनाई जाती है:
Action: Caption enhancement विफलताएँ आमतौर पर क्षणिक होती हैं (अंतर्निहित shortener या enhancement सेवा ने त्रुटि लौटाई)।
  • यदि postIds गैर-खाली है (कुछ प्लेटफ़ॉर्म सफलतापूर्वक पोस्ट किए गए), तो पूरे प्लेटफ़ॉर्म सेट को पुनः सबमिट न करें — यह सफल प्लेटफ़ॉर्म पर पोस्ट को डुप्लिकेट कर देगा। इसके बजाय, विफल प्लेटफ़ॉर्म की पहचान करने के लिए errors[] का निरीक्षण करें और केवल उन प्लेटफ़ॉर्म के साथ अनुरोध का पुनः प्रयास करें, या अपने स्वयं के idempotent retry flow पर भरोसा करें।
  • यदि postIds खाली या गुम है (schedule/post समय पर कुल विफलता), तो पूरे अनुरोध को सुरक्षित रूप से पुनः प्रयास करें।
  • यदि विफलता बनी रहती है, तो enhancement ध्वज (उदाहरण के लिए, shortenLinks छोड़ें) के बिना पोस्ट सबमिट करें या सपोर्ट से संपर्क करें।

Media Fetch / Crawler Access त्रुटियाँ

Code 440 — सोशल नेटवर्क मीडिया डाउनलोड नहीं कर सका (HTTP 400) तब लौटाया जाता है जब प्लेटफ़ॉर्म का publishing crawler आपके द्वारा प्रदान किए गए mediaUrl को डाउनलोड नहीं कर सकता — सबसे आम तौर पर क्योंकि robots.txt या एक WAF / bot-fight नियम crawler को अवरुद्ध कर रहा है (उदाहरण के लिए, Meta का facebookexternalhit)। details स्ट्रिंग upstream प्लेटफ़ॉर्म से आती है और अक्सर Meta/Instagram त्रुटि 2207052 टेक्स्ट होती है।
Code 138 — Instagram Media Fetch अवरुद्ध (HTTP 400) Instagram media-fetch विफलताओं के लिए फ़ॉलबैक कोड जब upstream प्रतिक्रिया 440 को ट्रिगर करने वाली प्रतिक्रिया से कम विशिष्ट होती है। details स्ट्रिंग में आमतौर पर "Restricted by robots.txt" या "HTTP error code 403" होता है। Code 138 का उपयोग aspect-ratio / format मुद्दों और अन्य सामान्य Instagram त्रुटियों के लिए भी किया जाता है, इसलिए media-fetch वेरिएंट details स्ट्रिंग द्वारा पहचाने योग्य है।
Code 379 — Threads पोस्टिंग त्रुटि तब लौटाया जाता है जब Threads प्रकाशन विफल हो जाता है। सबसे आम रूप से कोड 440 / 138 के समान media-fetch समस्या के कारण होता है जब समान mediaUrl के साथ दोनों प्लेटफ़ॉर्म पर प्रकाशित किया जाता है। Threads API विवरण स्ट्रिंग नहीं लौटाता है, इसलिए निदान के लिए आमतौर पर उसी publish में सह-प्रचलित Instagram 440 या 138 की जाँच करना आवश्यक है।
Action: पूर्ण समस्या निवारण के लिए Meta Media Crawler Blocked देखें, जिसमें robots.txt स्निपेट्स और एक सत्यापन कमांड शामिल है।

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 ले जाती है:
Action: कुछ मिनट प्रतीक्षा करें और पुनः प्रयास करें। Meta की per-Page दर-सीमा विंडो आमतौर पर Page पर बिना किसी कार्रवाई के एक घंटे के भीतर हल हो जाती है। उपयोगकर्ता को खाते को फिर से लिंक करने के लिए करें — यह Meta की तरफ से एक क्षणिक थ्रॉटल है, न कि प्रमाणीकरण विफलता।
यदि आपने पहले इस स्थिति को code: 161 (“Facebook authorization error … unlink and re-link”) के रूप में संभाला था, तो अपने एकीकरण को code: 444 को पहचानने और relink flow शुरू करने के बजाय बैकऑफ़ के साथ पुनः प्रयास करने के लिए अपडेट करें। 161 वर्गीकरण को अप्रैल 2026 में सही किया गया था।

Meta पहचान सत्यापन

Code 326 — Meta पहचान सत्यापन आवश्यक (HTTP 403) तब लौटाया जाता है जब अनुरोध स्वीकार करने से पहले Meta को कनेक्ट किए गए खाते के लिए अतिरिक्त पहचान सत्यापन की आवश्यकता होती है। यह Meta प्लेटफ़ॉर्म — Facebook, Instagram, Facebook Groups, Threads, और Messenger पर लागू होता है। खाते को पुनः कनेक्ट करने से यह हल नहीं होगा; सत्यापन Meta की तरफ पूरा किया जाना चाहिए।
Action: खाता स्वामी से Meta Business Support पर Meta का पहचान सत्यापन पूरा करवाएँ, फिर अनुरोध का पुनः प्रयास करें। उपयोगकर्ता को खाते को फिर से लिंक करने के लिए करें — फिर से लिंक करने से यह आवश्यकता समाप्त नहीं होगी।

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 खाता स्वामी को एक सूचना ईमेल भी भेजता है।
Action: Facebook में लॉग इन करें, अपनी प्रोफ़ाइल तस्वीर (ऊपरी-दाएँ) पर क्लिक करें, Help अनुभाग खोलें और Account Status चुनें। Meta का सपोर्ट सहायक वहाँ विशिष्ट प्रतिबंध कारण सामने लाता है और आपको अपील करने देता है। क्योंकि प्रतिबंध Meta द्वारा खाता स्तर पर लागू किया जाता है, यह कोड गैर-पुनः प्रयास योग्य है — इसके चारों ओर स्वचालित पुनः प्रयास तर्क का निर्माण न करें; पहले Meta के साथ प्रतिबंध हल करें।

छवि प्रारूप रूपांतरण त्रुटियाँ

Ayrshare स्वचालित रूप से WebP, HEIC, और AVIF छवियों को उन प्लेटफ़ॉर्म पर पोस्ट करने से पहले JPEG में परिवर्तित करता है जो उन्हें स्वीकार नहीं करते (Instagram, LinkedIn, TikTok, Google My Business, Threads, और WebP के लिए Snapchat; HEIC और AVIF के लिए सभी प्लेटफ़ॉर्म)। रूपांतरण भेजने के समय पारदर्शी रूप से चलता है। नीचे दी गई तीन त्रुटियाँ केवल तभी फ़ायर होती हैं जब रूपांतरण पाइपलाइन स्वयं पूरी नहीं हो सकती; यदि स्रोत छवि पहले से ही एक समर्थित प्रारूप में है, तो कोई रूपांतरण प्रयास नहीं किया जाता है और ये कोड सामने नहीं आएंगे। Code 450 — छवि प्रारूप रूपांतरण विफल (HTTP 400) छवि डाउनलोड की गई थी लेकिन JPEG के रूप में पुनः एन्कोड नहीं की जा सकी। सबसे आम कारण एक भ्रष्ट स्रोत फ़ाइल, कंटेनर के अंदर एक अप्रत्याशित आंतरिक प्रारूप, या एक छवि है जो रूपांतरण आकार सीमा से अधिक है।
Action: स्रोत mediaUrl को सीधे ब्राउज़र में खोलें ताकि यह पुष्टि हो सके कि यह रेंडर करता है। यदि हाँ, तो छवि को एक स्वच्छ JPEG या PNG में पुनः निर्यात करें और पोस्ट का पुनः प्रयास करें। Code 451 — रूपांतरण के लिए छवि डाउनलोड विफल (HTTP 400) रूपांतरण पाइपलाइन स्रोत छवि नहीं ला सका। सामान्य कारणों में मूल से 4xx/5xx प्रतिक्रिया, एक नेटवर्क टाइमआउट, एक रीडायरेक्ट श्रृंखला जो हॉप सीमा से अधिक है, या एक URL जो गैर-सार्वजनिक पते पर हल करता है (SSRF गार्ड द्वारा अवरुद्ध) शामिल हैं। जब मौजूद हो, details फ़ील्ड अंतर्निहित कारण स्ट्रिंग ले जाती है।
Action: पुष्टि करें कि mediaUrl सार्वजनिक रूप से पहुँच योग्य है (कोई auth नहीं, कोई robots.txt ब्लॉक नहीं, HTTPS पर हल होता है)। यदि URL रीडायरेक्ट करता है, तो सुनिश्चित करें कि अंतिम गंतव्य भी सार्वजनिक है और निजी नेटवर्क पर नहीं है। Code 452 — परिवर्तित छवि अपलोड विफल (HTTP 500) रूपांतरण सफल हुआ लेकिन Ayrshare परिवर्तित JPEG को अपने अस्थायी संग्रहण bucket पर स्टेज नहीं कर सका। यह Ayrshare की तरफ से एक आंतरिक विफलता है और पुनः प्रयास योग्य है।
Action: पोस्ट का पुनः प्रयास करें। यदि त्रुटि कई पुनः प्रयासों में बनी रहती है, तो 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 पाइपलाइन अपलोड स्वीकार करते समय टाइमआउट हो गया। यह आमतौर पर क्षणिक होता है और एक या दो मिनट के भीतर अपने आप हल हो जाता है।
Action: एक्सपोनेंशियल बैकऑफ़ के साथ 1–2 मिनट के बाद पोस्ट का पुनः प्रयास करें। पुनः प्रयास योग्य विफलताओं का पता लगाने के लिए HTTP स्टेटस के बजाय प्रतिक्रिया बॉडी पर retryAvailable फ़ील्ड पर शाखा करें। आप उसी payload को पुनः सबमिट करने के लिए retry post एंडपॉइंट का उपयोग कर सकते हैं। Code 454 — YouTube अपलोड सेवा अस्थायी रूप से अनुपलब्ध (HTTP 503) तब लौटाया जाता है जब YouTube का अपलोड एंडपॉइंट 5xx स्टेटस लौटाता है, या जब YouTube का कनेक्शन socket परत पर रीसेट या टाइमआउट हो गया (ECONNRESET, ETIMEDOUT, ESOCKETTIMEDOUT)। ये स्थितियाँ क्षणिक हैं।
Action: एक्सपोनेंशियल बैकऑफ़ के साथ पोस्ट का पुनः प्रयास करें। पुनः प्रयास योग्य विफलताओं का पता लगाने के लिए HTTP स्टेटस के बजाय प्रतिक्रिया बॉडी पर retryAvailable फ़ील्ड पर शाखा करें। आप उसी payload को पुनः सबमिट करने के लिए retry post एंडपॉइंट का उपयोग कर सकते हैं।

YouTube थंबनेल त्रुटियाँ Code 307

Code 307 तब लौटाया जाता है जब एक कस्टम 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 खाते को फिर से लिंक करना एक द्वितीयक कारण है।
Ayrshare जहाँ संभव हो प्रकाशन से पहले थंबनेल को भी सत्यापित करता है: फ़ाइल एक PNG या JPG/JPEG होनी चाहिए, 2MB या कम, और एक पहुँच योग्य URL से परोसी जानी चाहिए। एक थंबनेल समस्या पोस्ट को कभी विफल नहीं करती है — वीडियो हमेशा प्रकाशित होता है और विफलता हमेशा एक गैर-घातक 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) देखें।

Reddit पोस्टिंग त्रुटियाँ

Code 442 — Reddit प्रतिबंधित Subreddit (HTTP 400) तब लौटाया जाता है जब खाते को लक्ष्य subreddit पर पोस्ट करने से प्रतिबंधित कर दिया गया है। यह पुनः प्रयास योग्य नहीं है — यदि पोस्ट को जैसा है वैसा फिर से सबमिट किया जाता है तो सफल नहीं होगा। संदेश में प्रभावित subreddit नाम शामिल है (उदाहरण के लिए, r/news)।
Action: अपने लक्ष्य subreddits से प्रतिबंधित subreddit को हटाएँ। पोस्ट को अपरिवर्तित पुनः प्रयास करने से सफलता नहीं मिलेगी। Code 443 — Reddit शीर्षक में अस्वीकृत शब्द (HTTP 400) तब लौटाया जाता है जब एक subreddit पोस्ट को अस्वीकार कर देता है क्योंकि उसके शीर्षक में एक अस्वीकृत शब्द है। पुनः प्रयास करने से पहले शीर्षक संपादित करें — जैसा है वैसा पुनः सबमिट करने से सफलता नहीं मिलेगी। संदेश में प्रभावित subreddit नाम शामिल है (उदाहरण के लिए, r/news)।
Action: अस्वीकृत शब्द को हटाने के लिए पोस्ट शीर्षक संपादित करें, फिर पुनः प्रयास करें।

मॉडरेशन त्रुटियाँ

Code 438 — मॉडरेशन इनपुट अस्वीकृत (HTTP 400) POST /validate/moderation द्वारा तब लौटाया जाता है जब AI प्रदाता प्रदान किए गए इनपुट को अस्वीकार करता है — उदाहरण के लिए, एक असमर्थित फ़ाइल प्रकार। यह अनुरोध के साथ एक इनपुट समस्या है, न कि क्षणिक प्रसंस्करण विफलता।
Action: पुष्टि करें कि मॉडरेशन इनपुट मान्य है और एक समर्थित फ़ाइल प्रकार का उपयोग करता है, फिर पुनः सबमिट करें।
कोड 438 की तुलना कोड 331 से करें। कोड 331 उसी मॉडरेशन परिदृश्य को कवर करता है लेकिन प्रदाता की तरफ एक वास्तविक प्रसंस्करण विफलता का प्रतिनिधित्व करता है (HTTP 500, संदेश “There was an issue with the AI processing. Please try again.”)। कोड 331 एक क्षणिक सर्वर-साइड विफलता है जिसे आप पुनः प्रयास कर सकते हैं, जबकि कोड 438 इंगित करता है कि इनपुट स्वयं अस्वीकार कर दिया गया था और पुनः प्रयास करने से पहले सही किया जाना चाहिए।

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 अनुरोध को अस्वीकार करता है। पोस्टिंग अप्रभावित है।
Action: खाता स्वामी से नए analytics scopes प्रदान करने के लिए Social Accounts में अपने LinkedIn प्रोफ़ाइल को फिर से लिंक करवाएँ, फिर analytics अनुरोध का पुनः प्रयास करें। पुनः लिंक करने के बाद, त्रुटि साफ़ होने से पहले कुछ मिनट अनुमति दें: Ayrshare इस त्रुटि को संक्षेप में कैश करता है और LinkedIn भी token की अनुमतियों को कैश करता है, इसलिए एक पुनः लिंक की गई प्रोफ़ाइल analytics सफल होने से पहले ~5-10 मिनट तक कोड 475 लौटाती रह सकती है।

TikTok टिप्पणी त्रुटियाँ

Code 288 — TikTok टिप्पणी स्थगित / पोस्ट अभी भी संसाधित हो रहा है (HTTP 400) TikTok वीडियो को असिंक्रोनस रूप से संसाधित करता है, इसलिए एक ताज़ी प्रकाशित पोस्ट की id "pending" होती है जब तक TikTok का post.publish.publicly_available वेबहुक वास्तविक वीडियो id को हल नहीं करता। एक पोस्ट के विरुद्ध एक get-comments, टिप्पणी, या उत्तर अनुरोध जो अभी भी संसाधित हो रहा है (या जिसकी id "failed" है) TikTok को किसी भी कॉल से पहले अस्वीकार कर दिया जाता है और सामान्य विफलता के बजाय कोड 288 लौटाता है।
Action: TikTok को प्रसंस्करण पूरा करने तक प्रतीक्षा करें, फिर पुनः प्रयास करें। tikTokPublished Scheduled Action वेबहुक सुनें या /history को तब तक पोल करें जब तक पोस्ट id हल की गई संख्यात्मक वीडियो id न हो। पोस्ट के हल होने पर एक पहली टिप्पणी स्वचालित रूप से पोस्ट होती है, इसलिए इसे पुनः प्रयास करने की आवश्यकता नहीं है। एक "failed" पोस्ट के लिए संदेश इसके बजाय नोट करता है कि वीडियो प्रकाशित होने में विफल रहा और कार्रवाई नहीं चलेगी।

त्रुटि संदेश अनुवाद

API त्रुटि संदेश प्रतिक्रिया को स्वचालित रूप से आपकी पसंद की भाषा में अनुवादित किया जा सकता है। यह उपयोगी है यदि आप अपने उपयोगकर्ता को उनकी पसंदीदा भाषा में सीधे त्रुटि प्रदर्शित करना चाहते हैं। यदि आप सोशल लिंकिंग पृष्ठ की भाषा चुनना चाहते हैं तो यहाँ देखें। हैडर में शामिल करें:
जहाँ Language_Code उपलब्ध language codes में से एक है। उदाहरण के लिए, निम्नलिखित त्रुटि को फ़्रेंच में अनुवादित करेगा।
हमारी प्रणाली स्वचालित रूप से त्रुटि संदेश भाषा का पता लगाएगी।