Ontwikkelaarsdocumentatie
Los problemen met API-, CLI- en MCP-verbindingen op
Los aanmeld-, machtigings-, schema-, upload- en onzekere schrijffouten op zonder inloggegevens bloot te stellen of geaccepteerd werk te dupliceren.
Lezen als MarkdownBeoordeeld door het SosoAPI-team ·
Verkeerde browser of geblokkeerde lokale aanmelding
Stop de openstaande aanmelding en voer auth login --no-open uit. Open de nieuw getoonde URL in het gewenste browserprofiel. Controleer account en werkruimte vóór toestemming en gebruik slechts één browserprofiel voor die aanmeldlink. Identificeer bij een bezette poort 8789 het luisterende proces en stop het alleen als het een door jou gestarte aanmeldprocedure is.
npx sosoapi auth login --no-openlsof -nP -iTCP:8789 -sTCP:LISTEN401, 403 en niet-beschikbare accounts
Controleer bij 401 of je met actuele inloggegevens bent aangemeld. Controleer bij 403 werkruimterol, gekozen bereik en vereiste bevoegdheid. Gebruik auth status en verifieer e-mailadres en toegestaan inloggegevenstype. Wijzig toegang alleen als die bewerking dat vereist; een ander toolprofiel verleent geen machtiging.
Controleer het socialmedia-account apart. Lees verbinding en mogelijkheden en verbind alleen opnieuw als de provider nieuwe toestemming nodig heeft. Een interne servicefout is geen reden om een gezonde verbinding opnieuw te maken.
400-validatie en versieverschillen
Lees antwoordinhoud en validatieveldpaden. Validatiefouten kunnen een ZodError bevatten; handlerfouten kunnen error, message en code gebruiken. Vergelijk het verzoek met het geïnstalleerde contract en werk zo nodig het clientpakket bij. Corrigeer de genoemde velden zonder verplichte waarden te verwijderen of niet-ondersteunde filters toe te voegen.
npx sosoapi api contract --route /studio-api/scheduled-posts/409, 429, 5xx of een schrijfhandeling met time-out
Lees bij 409 de nieuwste resourceversie en beschikbare acties voordat je iets wijzigt. Wacht bij 429 volgens Retry-After en verlaag gelijktijdigheid. Bewaar bij een schrijf-time-out of 5xx de ID en controleer eerst het bestaande resultaat: de server kan het verzoek vóór de verbindingsfout hebben geaccepteerd.
Probeer alleen opnieuw wanneer de bewerking en huidige status dit toestaan. Behoud dezelfde sleutel voor dezelfde inhoud en maak geen vervanging om een onzeker resultaat te omzeilen. Los authenticatiefouten op vóór opnieuw proberen. Een wachtende achtergrondtaak kan al een uitvoeringsfout bevatten die controle verdient.
Problemen met uploaden of tooldetectie
Lokale upload accepteert ondersteunde mediabestanden tot 500 MiB uit de werkmap, tijdelijke map, Pictures/Movies/Videos of mappen in SOSOAPI_UPLOAD_ROOTS. Mappen die met een punt beginnen en symlinks buiten die hoofdmappen worden geweigerd. Voeg de specifieke benodigde mediamap toe in plaats van je hele thuismap. Een HTTP-verbinding kan geen lokale bestanden lezen.
Verbind bij ontbrekende tools de client opnieuw en vergelijk profiel en verbindingstype met de naslag. Controleer of de tools in het huidige gesprek geladen zijn; alleen een opgeslagen servernaam bevestigt dat niet.
Deel nuttige diagnostische gegevens veilig
Deel bewerkingsnaam, tijdstip, HTTP-status, veilige foutcode en request_id of x-request-id indien beschikbaar. Vermeld de CLI-versie en of je lokale of externe MCP gebruikte. Verwijder tokens, cookies, autorisatielinks, ondertekende media-URLs, klantinhoud en privé-IDs. Deel de relevante fout in plaats van een inloggegevensbestand of volledig antwoord.