API, CLI और MCP कनेक्शन की समस्याएँ हल करें

गलत ब्राउज़र या ब्लॉक किया गया लोकल लॉगिन

लंबित लॉगिन रोकें, फिर auth login --no-open चलाएँ। नया प्रिंट URL इच्छित ब्राउज़र प्रोफ़ाइल में खोलें। एक्सेस से पहले खाता और वर्कस्पेस जाँचें और उस लॉगिन लिंक के लिए केवल एक ब्राउज़र प्रोफ़ाइल इस्तेमाल करें। पोर्ट 8789 व्यस्त हो, तो listener पहचानें और केवल अपनी शुरू की लॉगिन प्रक्रिया होने पर रोकें।

npx sosoapi auth login --no-open

lsof -nP -iTCP:8789 -sTCP:LISTEN

401, 403 और अनुपलब्ध खाते

401 पर वर्तमान क्रेडेंशियल से साइन इन होने की जाँच करें। 403 पर वर्कस्पेस भूमिका, चुना दायरा और ऑपरेशन की आवश्यक क्षमता जाँचें। auth status से खाते का ईमेल और स्वीकार्य क्रेडेंशियल प्रकार सत्यापित करें। ऑपरेशन को ज़रूरत होने पर ही एक्सेस बदलें; टूल प्रोफ़ाइल बदलने से अनुमति नहीं मिलेगी।

सोशल खाता अलग जाँचें। कनेक्शन और क्षमताएँ पढ़ें और प्रोवाइडर को नई सहमति चाहिए तभी फिर जोड़ें। आंतरिक सेवा त्रुटि स्वस्थ कनेक्शन फिर बनाने का कारण नहीं है।

• प्रमाणीकरण और अनुमतियाँ
• संपूर्ण API संदर्भ

400 वैलिडेशन और संस्करण में अंतर

रिस्पॉन्स बॉडी और वैलिडेशन फ़ील्ड पाथ पढ़ें। वैलिडेशन त्रुटि में ZodError हो सकता है; हैंडलर त्रुटियाँ error, message और code फ़ील्ड ले सकती हैं। अनुरोध को इंस्टॉल कॉन्ट्रैक्ट से मिलाएँ और ज़रूरत पर क्लाइंट पैकेज अपडेट करें। आवश्यक मान हटाए या असमर्थित फ़िल्टर जोड़े बिना बताए फ़ील्ड ठीक करें।

npx sosoapi api contract --route /studio-api/scheduled-posts/

409, 429, 5xx या टाइमआउट हुई राइट

409 पर बदलाव से पहले नवीनतम संसाधन संस्करण और उपलब्ध कार्रवाइयाँ पढ़ें। 429 पर Retry-After के अनुसार प्रतीक्षा करें और समवर्ती अनुरोध घटाएँ। राइट टाइमआउट या 5xx हो, तो ID रखें और पहले मौजूदा परिणाम जाँचें: कनेक्शन विफल होने से पहले सर्वर उसे स्वीकार कर सकता है।

पुनः प्रयास केवल ऑपरेशन और वर्तमान स्थिति की अनुमति पर करें। समान पेलोड की key समान रखें और अनिश्चित परिणाम से बचने के लिए प्रतिस्थापन न बनाएँ। पहले प्रमाणीकरण विफलता ठीक करें। लंबित बैकग्राउंड जॉब की स्थिति में पहले से जाँचने योग्य निष्पादन त्रुटि हो सकती है।

• प्रकाशन संदर्भ

अपलोड या टूल खोज की समस्याएँ

लोकल अपलोड वर्किंग डायरेक्टरी, टेम्प फ़ोल्डर, Pictures/Movies/Videos या SOSOAPI_UPLOAD_ROOTS में दिए फ़ोल्डरों से अधिकतम 500 MiB की समर्थित मीडिया फ़ाइल लेता है। डॉट-फ़ोल्डर और इन रूट से बाहर जाने वाले symlink अस्वीकार हैं। पूरी home डायरेक्टरी के बजाय ज़रूरी मीडिया फ़ोल्डर ही जोड़ें। HTTP कनेक्शन लोकल फ़ाइल नहीं पढ़ सकता।

टूल गायब हों, तो क्लाइंट फिर जोड़ें और प्रोफ़ाइल व कनेक्शन प्रकार संदर्भ से मिलाएँ। टूल वर्तमान बातचीत में लोड हैं, यह जाँचें; केवल सहेजा सर्वर नाम इसकी पुष्टि नहीं करता।

• MCP टूल संदर्भ

उपयोगी जाँच जानकारी सुरक्षित रूप से साझा करें

ऑपरेशन नाम, समय, HTTP स्टेटस, सुरक्षित त्रुटि कोड और उपलब्ध request_id या x-request-id दें। CLI संस्करण और लोकल या रिमोट MCP का विवरण दें। टोकन, cookies, प्राधिकरण लिंक, हस्ताक्षरित मीडिया URLs, ग्राहक कंटेंट और निजी IDs हटाएँ। क्रेडेंशियल फ़ाइल या पूरे रिस्पॉन्स के बजाय संबंधित त्रुटि साझा करें।

• SosoAPI से संपर्क करें