Ontwikkelaarsdocumentatie
Vragen en antwoorden voor ontwikkelaars
Directe antwoorden over npm-aliassen, de keuze tussen API en MCP, authenticatie, media, veilig opnieuw proberen, aanvraaglimieten en wat gepubliceerd echt betekent.
Lezen als MarkdownBeoordeeld door het SosoAPI-team ·
Zijn de vier npm-pakketten verschillende SDK's?
Nee. Installeer sosoapi of één alias: @sosoapi/cli, sosoapi-cli of sosoapi-mcp. Elke alias gebruikt exact dezelfde versie van de CLI- en MCP-implementatie. Je hebt er maar één nodig.
Gebruik ik HTTP, CLI of MCP?
Gebruik HTTP vanaf je server, de CLI voor shellautomatisering en schemabekijken, of MCP met een compatibele agent. Ze gebruiken dezelfde openbare API-contracten. MCP biedt ook lokale bestandsupload en een tool voor berichten met afbeeldings-URL die mediavoorbereiding afhandelt. Houd serverinloggegevens uit browsercode.
Publiceert configuratie of OAuth-toestemming een bericht?
Nee. Configuratie publiceert niets. OAuth-toestemming verleent doorlopende toegang binnen je gekozen bereik, zonder nieuwe browsergoedkeuring per schrijfhandeling. Vertel je agent wanneer die op beoordeling moet wachten en controleer account, inhoud en tijdstip voordat je vraagt te publiceren.
Betekent HTTP 200 of 202 dat iets gepubliceerd is?
Nee. Het verzoek kan zijn geaccepteerd, ingepland of nog in verwerking zijn. Bewaar de bericht-ID en lees dezelfde Scheduled Post totdat het resultaat publicatie bevestigt. Voeg indien beschikbaar de permalink toe en rapporteer elke bestemming afzonderlijk.
Kan ik opnieuw proberen na een time-out?
Controleer eerst de bestaande bewerking. Bewaar de Scheduled Post-ID en hergebruik dezelfde idempotentiesleutel voor hetzelfde verzoek. Gewijzigde inhoud betekent een ander verzoek. Gebruik om een bestaand bericht opnieuw te proberen, bij te werken of te annuleren de huidige versie en een door SosoAPI voor die status aangeboden actie.
Waarom ontbreekt er een tool in mijn client?
Controleer profiel, verbindingstype en of je client de server opnieuw heeft geladen. Core verbergt beheertools; HTTP-verbindingen bevatten geen lokale bestandsupload. De toolnaslag toont beschikbaarheid. Het profiel wijzigen verandert geen accountmachtigingen of geschiktheid.
Kan externe MCP een lokaal bestand uploaden?
Nee. Gebruik lokale MCP om een bestand uit een toegestane map te uploaden, of importeer een openbare media-URL via HTTP. Controleer de import tot gereedheid en gebruik daarna geregistreerde media-ID en canonieke URL samen. Een geaccepteerde import is nog in behandeling.
Wat zijn de aanvraag- en abonnementslimieten?
Controleer elk schema op veld-, lijst- en pagineringslimieten. studio-api staat voor menselijke sessies 240 verzoeken per minuut per gebruiker toe, met een apart budget van 480 per minuut voor de machine-inloggegevens van die gebruiker. Volg 429 en Retry-After. Abonnementsquota, providerlimieten en accountgeschiktheid staan los van elkaar; lees actuele facturerings- en mogelijkheidsinformatie vóór een grote uitvoering.
Waar staan Markdown en schema's?
Voeg .md toe aan de URL van een handleiding, API-bewerking of MCP-tool voor de Markdown-versie. De API-index verwijst naar het openbare JSON-contract en OpenAPI 3.1-document. Begin bij llms.txt voor een pagina-index of llms-full.txt voor de volledige naslag in beide talen. Deze bestanden bevatten openbare documentatie, geen accountgegevens of inloggegevens.
Garanderen deze documenten vindbaarheid of AI-verwijzingen?
Nee. HTML-pagina's, canonieke URLs, gestructureerde metadata en Markdown helpen systemen de documentatie te lezen. Zoekmachines en AI-diensten kiezen nog steeds zelf wat ze indexeren, rangschikken of citeren. Controleer die resultaten los van de beschikbaarheid van de pagina's.