Entwicklerdokumentation
Entwicklerfragen und Antworten
Direkte Antworten zu npm-Aliasen, API-/MCP-Wahl, Authentifizierung, Medien, sicheren Wiederholungen, Ratenlimits und der tatsächlichen Bedeutung von „veröffentlicht“.
Als Markdown lesenVom SosoAPI-Team geprüft ·
Sind die vier npm-Pakete unterschiedliche SDKs?
Nein. Installiere sosoapi oder einen seiner Aliase: @sosoapi/cli, sosoapi-cli oder sosoapi-mcp. Jeder Alias nutzt exakt dieselbe CLI- und MCP-Version. Du benötigst nur einen.
Soll ich HTTP, CLI oder MCP verwenden?
Nutze HTTP vom Server, CLI für Shell-Automatisierung und Schemaprüfung oder MCP mit kompatiblem Agenten. Sie verwenden dieselben öffentlichen API-Verträge. MCP bietet auch lokalen Dateiupload und ein Bild-URL-Veröffentlichungstool, das Medien vorbereitet. Halte Serverzugangsdaten aus Browsercode heraus.
Veröffentlicht die Einrichtung oder OAuth-Zustimmung einen Beitrag?
Nein. Die Einrichtung veröffentlicht nichts. OAuth-Zustimmung gewährt fortlaufenden Zugriff im gewählten Umfang, ohne neue Browserfreigabe für jeden Schreibvorgang. Sage deinem Agenten, wann er auf Prüfung warten soll, und prüfe Konto, Inhalt und Zeitpunkt vor dem Veröffentlichungsauftrag.
Bedeutet HTTP 200 oder 202 „veröffentlicht“?
Nein. Die Anfrage kann angenommen, geplant oder noch in Bearbeitung sein. Speichere die Beitrags-ID und lies denselben Scheduled Post bis zur bestätigten Veröffentlichung. Ergänze verfügbare Permalinks und melde jedes Ziel separat.
Darf ich nach einem Timeout erneut versuchen?
Prüfe zuerst die bestehende Operation. Behalte Scheduled-Post-ID und denselben Idempotenzschlüssel für dieselbe Anfrage. Ein geänderter Payload ist eine andere Anfrage. Nutze zum Wiederholen, Aktualisieren oder Abbrechen eines bestehenden Beitrags dessen aktuelle Version und eine von SosoAPI für diesen Zustand angebotene Aktion.
Warum fehlt ein Tool in meinem Client?
Prüfe Profil, Verbindungstyp und ob dein Client den Server neu geladen hat. core blendet Verwaltungstools aus; HTTP-Verbindungen enthalten keinen lokalen Dateiupload. Die Tool-Referenz zeigt Verfügbarkeit. Profilwechsel ändern keine Kontoberechtigungen oder Eignung.
Kann Remote-MCP eine lokale Datei hochladen?
Nein. Nutze lokales MCP zum Dateiupload aus erlaubten Ordnern oder importiere öffentliche Medien-URLs über HTTP. Prüfe den Import bis zur Bereitschaft und nutze registrierte Asset-ID und kanonische URL gemeinsam. Ein angenommener Import ist noch in Bearbeitung.
Welche Raten- und Tarifgrenzen gelten?
Prüfe jedes Schema auf Feld-, Listen- und Paginierungsgrenzen. studio-api erlaubt 240 Anfragen pro Minute und Nutzer für menschliche Sitzungen, mit einem separaten Kontingent von 480 pro Minute für dessen Maschinenzugangsdaten. Beachte 429 und Retry-After. Tarifkontingente, Anbietergrenzen und Kontoeignung sind getrennt; lies vor einem großen Durchlauf aktuelle Abrechnungs- und Funktionsinformationen.
Wo sind Markdown und Schemas?
Ergänze .md an URLs von Anleitungen, API-Operationen oder MCP-Tools für Markdown. Der API-Index verlinkt öffentlichen JSON-Vertrag und OpenAPI-3.1-Dokument. llms.txt bietet den Seitenindex, llms-full.txt die vollständige Referenz in beiden Sprachen. Diese Dateien enthalten öffentliche Dokumentation, keine Kontodaten oder Zugangsdaten.
Garantiert diese Dokumentation Suchtreffer oder KI-Zitate?
Nein. HTML-Seiten, kanonische URLs, strukturierte Metadaten und Markdown helfen Systemen beim Lesen. Suchmaschinen und KI-Dienste entscheiden weiterhin selbst über Indexierung, Ranking und Zitate. Prüfe diese Ergebnisse getrennt von der Seitenverfügbarkeit.