Utvecklardokumentation
Frågor och svar för utvecklare
Raka svar om npm-alias, val av API och MCP, autentisering, medier, säkra nya försök, anropsgränser och vad publicerat faktiskt betyder.
Läs som MarkdownGranskat av SosoAPI-teamet ·
Är de fyra npm-paketen olika SDK:er?
Nej. Installera sosoapi eller ett av dess alias: @sosoapi/cli, sosoapi-cli eller sosoapi-mcp. Varje alias använder exakt samma version av CLI- och MCP-implementationen. Du behöver bara ett.
Ska jag använda HTTP, CLI eller MCP?
Använd HTTP från din server, CLI för shell-automatisering och schemagranskning eller MCP med en kompatibel agent. De använder samma offentliga API-kontrakt. MCP erbjuder även lokal filuppladdning och ett verktyg för bild-URL-inlägg som sköter medieförberedelser åt dig. Håll serveruppgifter borta från webbläsarkod.
Publicerar konfiguration eller OAuth-samtycke ett inlägg?
Nej. Konfiguration publicerar ingenting. OAuth-samtycke ger fortlöpande åtkomst inom det omfång du väljer utan ett nytt webbläsargodkännande för varje skrivning. Tala om för agenten när den ska vänta på granskning och kontrollera konto, innehåll och tid innan du ber den publicera.
Betyder HTTP 200 eller 202 att inlägget har publicerats?
Nej. Begäran kan vara accepterad, schemalagd eller fortfarande under bearbetning. Spara inläggs-ID:t och läs samma Scheduled Post tills resultatet bekräftar publicering. Inkludera permalänken när den finns och redovisa varje destinations resultat separat.
Kan jag försöka igen efter en timeout?
Kontrollera först den befintliga åtgärden. Behåll Scheduled Post-ID:t och återanvänd samma idempotensnyckel för samma begäran. Ändrar du payload är det en annan begäran. För nya försök, uppdatering eller avbrytande av ett befintligt inlägg använder du aktuell version och en åtgärd som SosoAPI erbjuder för den statusen.
Varför saknas ett verktyg i min klient?
Kontrollera profil, anslutningstyp och om klienten har laddat om servern. Core döljer administrationsverktyg; HTTP-anslutningar saknar lokal filuppladdning. Verktygsreferensen visar tillgänglighet. Att byta profil ändrar inte kontobehörigheter eller rätt till funktioner.
Kan fjärr-MCP ladda upp en lokal fil?
Nej. Använd lokal MCP för att ladda upp en fil från en tillåten mapp eller importera en offentlig medie-URL via HTTP. Kontrollera importen tills den är klar och använd sedan registrerat mediefils-ID och kanonisk URL tillsammans. En accepterad import pågår fortfarande.
Vilka anrops- och abonnemangsgränser gäller?
Kontrollera varje schema för fält-, list- och sidindelningsgränser. studio-api tillåter 240 anrop per minut och användare för mänskliga sessioner, med en separat pott på 480 per minut för användarens maskinuppgifter. Följ 429 och Retry-After. Abonnemangskvoter, leverantörsgränser och kontobehörighet är separata; läs aktuella fakturerings- och funktionsuppgifter före en större körning.
Var finns Markdown och scheman?
Lägg till .md i en guide-, API-åtgärds- eller MCP-verktygs-URL för dess Markdown-version. API-indexet länkar till offentligt JSON-kontrakt och OpenAPI 3.1-dokument. Börja med llms.txt för ett sidindex eller llms-full.txt för hela referensen på båda språken. Filerna innehåller offentlig dokumentation, inga kontodata eller autentiseringsuppgifter.
Garanterar dessa dokument synlighet i sökresultat eller AI-citeringar?
Nej. HTML-sidor, kanoniska URL:er, strukturerade metadata och Markdown hjälper system att läsa dokumentationen. Sökmotorer och AI-tjänster väljer fortfarande vad de indexerar, rangordnar eller citerar. Kontrollera dessa resultat separat från sidornas tillgänglighet.