Utviklerdokumentasjon
Spørsmål og svar for utviklere
Direkte svar om npm-aliaser, valg av API og MCP, autentisering, medier, trygge nye forsøk, frekvensgrenser og hva publisert faktisk betyr.
Les som MarkdownGjennomgått av SosoAPI-teamet ·
Er de fire npm-pakkene forskjellige SDK-er?
Nei. Installer sosoapi eller ett av aliasene: @sosoapi/cli, sosoapi-cli eller sosoapi-mcp. Hvert alias bruker nøyaktig samme versjon av CLI- og MCP-implementasjonen. Du trenger bare ett.
Bør jeg bruke HTTP, CLI eller MCP?
Bruk HTTP fra serveren din, CLI for shell-automatisering og skjemainspeksjon, eller MCP med en kompatibel agent. De bruker de samme offentlige API-kontraktene. MCP tilbyr også lokal filopplasting og et verktøy for bilde-URL-innlegg som håndterer medieforberedelse for deg. Hold serverlegitimasjon unna nettleserkode.
Publiserer oppsett eller OAuth-samtykke et innlegg?
Nei. Oppsettet publiserer ingenting. OAuth-samtykke gir vedvarende tilgang innenfor omfanget du velger, uten ny nettlesergodkjenning for hver skriveoperasjon. Fortell agenten når den skal vente på gjennomgang, og kontroller konto, innhold og tidspunkt før du ber den publisere.
Betyr HTTP 200 eller 202 at noe er publisert?
Nei. Forespørselen kan være akseptert, planlagt eller fortsatt under behandling. Lagre innleggs-ID-en og les det samme planlagte innlegget til resultatet bekrefter publisering. Ta med permalenken når tilgjengelig og rapporter resultatet for hvert mål separat.
Kan jeg prøve igjen etter tidsavbrudd?
Kontroller eksisterende operasjon først. Behold ID-en til det planlagte innlegget og gjenbruk samme idempotensnøkkel for samme forespørsel. Endret nyttelast er en annen forespørsel. Bruk gjeldende versjon og en handling SosoAPI tilbyr for tilstanden for å prøve på nytt, oppdatere eller avbryte et eksisterende innlegg.
Hvorfor mangler et verktøy i klienten min?
Kontroller profil, tilkoblingstype og om klienten har lastet serveren på nytt. Core skjuler administrasjonsverktøy; HTTP-tilkoblinger inkluderer ikke lokal filopplasting. Verktøyreferansen viser tilgjengelighet. Profilendring endrer ikke kontotillatelser eller kvalifikasjon.
Kan ekstern MCP laste opp en lokal fil?
Nei. Bruk lokal MCP til å laste opp en fil fra en tillatt mappe, eller importer en offentlig medie-URL over HTTP. Kontroller importen til den er klar, og bruk deretter registrert ressurs-ID og kanonisk URL sammen. En akseptert import pågår fortsatt.
Hva er frekvens- og abonnementsgrensene?
Kontroller hvert skjema for grenser for felter, lister og paginering. studio-api tillater 240 forespørsler per minutt per bruker for menneskelige økter, med en separat kvote på 480 per minutt for brukerens maskinlegitimasjon. Følg 429 og Retry-After. Abonnementskvoter, leverandørgrenser og kontokvalifikasjon er separate; les gjeldende fakturerings- og funksjonsinformasjon før en stor kjøring.
Hvor finnes Markdown og skjemaer?
Legg til .md i URL-en til en veiledning, API-operasjon eller et MCP-verktøy for Markdown-versjonen. API-indeksen lenker til offentlig JSON-kontrakt og OpenAPI 3.1-dokument. Begynn med llms.txt for sideindeks eller llms-full.txt for full referanse på begge språk. Disse filene inneholder offentlig dokumentasjon, ikke kontodata eller påloggingsopplysninger.
Garanterer denne dokumentasjonen synlighet i søk eller AI-siteringer?
Nei. HTML-sider, kanoniske URL-er, strukturerte metadata og Markdown hjelper systemer med å lese dokumentasjonen. Søkemotorer og AI-tjenester velger fortsatt hva de indekserer, rangerer eller siterer. Kontroller disse resultatene separat fra om sidene er tilgjengelige.