डेवलपर दस्तावेज़
डेवलपर के सवाल-जवाब
npm उपनाम, API और MCP चुनाव, प्रमाणीकरण, मीडिया, सुरक्षित पुनः प्रयास, दर सीमाएँ और प्रकाशित के वास्तविक अर्थ पर सीधे जवाब।
Markdown में पढ़ेंSosoAPI टीम द्वारा समीक्षा ·
क्या चार npm पैकेज अलग SDK हैं?
नहीं। sosoapi या उसके किसी एक उपनाम को इंस्टॉल करें: @sosoapi/cli, sosoapi-cli या sosoapi-mcp। हर उपनाम CLI और MCP implementation का ठीक वही संस्करण इस्तेमाल करता है। केवल एक चाहिए।
मुझे HTTP, CLI या MCP इस्तेमाल करना चाहिए?
सर्वर से HTTP, शेल ऑटोमेशन व स्कीमा जाँच के लिए CLI या संगत एजेंट के साथ MCP इस्तेमाल करें। सभी समान सार्वजनिक API कॉन्ट्रैक्ट इस्तेमाल करते हैं। MCP लोकल फ़ाइल अपलोड और मीडिया तैयारी संभालने वाला image-URL पोस्टिंग टूल भी देता है। सर्वर क्रेडेंशियल ब्राउज़र कोड से बाहर रखें।
क्या सेटअप या OAuth सहमति से पोस्ट प्रकाशित होती है?
नहीं। सेटअप कुछ प्रकाशित नहीं करता। OAuth सहमति चुने दायरे में निरंतर एक्सेस देती है, हर राइट के लिए नई ब्राउज़र अनुमति के बिना। एजेंट को बताएँ कि समीक्षा के लिए कब प्रतीक्षा करनी है और प्रकाशित करने को कहने से पहले खाता, कंटेंट व समय जाँचें।
क्या HTTP 200 या 202 का अर्थ प्रकाशित है?
नहीं। अनुरोध स्वीकार, निर्धारित या अभी प्रोसेसिंग में हो सकता है। post ID सहेजें और प्रकाशन की पुष्टि तक वही Scheduled Post पढ़ें। उपलब्ध हो तो परमालिंक दें और हर गंतव्य का परिणाम अलग बताएँ।
क्या टाइमआउट के बाद फिर प्रयास कर सकता हूँ?
पहले मौजूदा ऑपरेशन जाँचें। Scheduled Post ID रखें और समान अनुरोध के लिए समान idempotency key इस्तेमाल करें। पेलोड बदले तो अनुरोध अलग है। मौजूदा पोस्ट का पुनः प्रयास, अपडेट या रद्दीकरण उसके वर्तमान संस्करण और उस स्थिति में SosoAPI की उपलब्ध कार्रवाई से करें।
मेरे क्लाइंट में कोई टूल क्यों नहीं है?
प्रोफ़ाइल, कनेक्शन प्रकार और क्लाइंट द्वारा सर्वर रीलोड होने की जाँच करें। Core प्रशासनिक टूल छिपाता है; HTTP कनेक्शन में लोकल फ़ाइल अपलोड नहीं है। टूल संदर्भ में उपलब्धता है। प्रोफ़ाइल बदलने से खाते की अनुमति या पात्रता नहीं बदलती।
क्या रिमोट MCP लोकल फ़ाइल अपलोड कर सकता है?
नहीं। अनुमत फ़ोल्डर से फ़ाइल अपलोड करने के लिए लोकल MCP या सार्वजनिक मीडिया URL इम्पोर्ट करने के लिए HTTP इस्तेमाल करें। तैयार होने तक इम्पोर्ट जाँचें, फिर पंजीकृत asset ID और कैनोनिकल URL साथ इस्तेमाल करें। स्वीकृत इम्पोर्ट अभी प्रगति में है।
दर और प्लान की सीमाएँ क्या हैं?
हर स्कीमा में फ़ील्ड, सूची और पेजिनेशन की सीमाएँ जाँचें। studio-api मानव सेशन के लिए हर यूज़र को प्रति मिनट 240 अनुरोध देता है, और उसी यूज़र के मशीन क्रेडेंशियल के लिए अलग 480-प्रति-मिनट बकेट है। 429 और Retry-After का पालन करें। प्लान कोटा, प्रोवाइडर सीमाएँ और खाते की पात्रता अलग हैं; बड़े रन से पहले वर्तमान बिलिंग और क्षमता जानकारी पढ़ें।
Markdown और स्कीमा कहाँ हैं?
Markdown संस्करण के लिए गाइड, API ऑपरेशन या MCP टूल URL में .md जोड़ें। API इंडेक्स में सार्वजनिक JSON कॉन्ट्रैक्ट और OpenAPI 3.1 दस्तावेज़ के लिंक हैं। पेज इंडेक्स के लिए llms.txt या दोनों भाषाओं के पूरे संदर्भ के लिए llms-full.txt से शुरू करें। इनमें सार्वजनिक दस्तावेज़ हैं, खाता डेटा या क्रेडेंशियल नहीं।
क्या ये दस्तावेज़ सर्च या AI उद्धरण की गारंटी देंगे?
नहीं। HTML पेज, कैनोनिकल URLs, संरचित मेटाडेटा और Markdown सिस्टम को दस्तावेज़ पढ़ने में मदद करते हैं। क्या इंडेक्स, रैंक या उद्धृत करना है, सर्च इंजन और AI सेवाएँ ही चुनती हैं। पेज उपलब्ध होने से अलग उन परिणामों की जाँच करें।