Fejlesztői dokumentáció
API-, CLI- és MCP-kapcsolatok hibaelhárítása
Oldd meg a bejelentkezési, engedély-, séma-, feltöltési és bizonytalanírás-hibákat hitelesítő adatok felfedése vagy elfogadott munka duplikálása nélkül.
Olvasás Markdown formátumbanEllenőrizte a SosoAPI csapata ·
Rossz böngésző vagy blokkolt helyi bejelentkezés
Állítsd le a függő bejelentkezést, majd futtasd az auth login --no-open parancsot. Az újonnan kiírt URL-t a kívánt böngészőprofilban nyisd meg. Hozzáférés engedélyezése előtt ellenőrizd a fiókot és munkaterületet, és a linkhez csak egy böngészőprofilt használj. Ha a 8789 port foglalt, azonosítsd a figyelő folyamatot, és csak akkor állítsd le, ha te indítottad bejelentkezéshez.
npx sosoapi auth login --no-openlsof -nP -iTCP:8789 -sTCP:LISTEN401, 403 és nem elérhető fiókok
401 esetén ellenőrizd, hogy aktuális hitelesítő adattal vagy-e bejelentkezve. 403-nál ellenőrizd a munkaterületi szerepkört, választott hatókört és szükséges képességet. Használd az auth status parancsot, és ellenőrizd a fiók e-mail-címét és elfogadott hitelesítőadat-típusát. Csak a művelethez szükséges hozzáférést módosítsd; az eszközprofil-váltás nem ad engedélyt.
A közösségi fiókot külön ellenőrizd. Olvasd a kapcsolatát és képességeit, és csak megújított szolgáltatói hozzájárulás szükségessége esetén kapcsolódj újra. Belső szolgáltatási hiba nem ok egy egészséges kapcsolat újralétrehozására.
400 ellenőrzés és verzióeltérés
Olvasd el a válasz törzsét és az ellenőrzési mezőútvonalakat. Az ellenőrzési hibák ZodError értéket, a kezelőhibák error, message és code mezőket használhatnak. Hasonlítsd a kérést a telepített szerződéshez, és szükség esetén frissítsd a kliens csomagját. A hibában nevezett mezőket javítsd; ne távolíts el kötelező értéket, és ne adj nem támogatott szűrőt.
npx sosoapi api contract --route /studio-api/scheduled-posts/409, 429, 5xx vagy időtúllépéses írás
409 esetén módosítás előtt olvasd a legfrissebb erőforrás-verziót és elérhető műveleteket. 429 esetén várj a Retry-After szerint, és csökkentsd a párhuzamosságot. Időtúllépéses vagy 5xx írásnál őrizd meg az azonosítót, és előbb ellenőrizd a meglévő eredményt: a szerver elfogadhatta a kérést a kapcsolat megszakadása előtt.
Csak akkor próbáld újra, ha a művelet és aktuális állapota engedi. Azonos payloadhoz azonos kulcsot használj, és bizonytalan eredményt ne kerülj meg helyettesítő létrehozásával. Újrapróbálás előtt javítsd a hitelesítési hibákat. A függő háttérfeladat állapota már tartalmazhat megvizsgálandó végrehajtási hibát.
Feltöltési vagy eszközfelderítési problémák
A helyi feltöltés legfeljebb 500 MiB méretű támogatott médiafájlokat fogad a munkakönyvtárból, ideiglenes mappából, Pictures/Movies/Videos mappákból vagy SOSOAPI_UPLOAD_ROOTS helyekről. A ponttal kezdődő mappákat és e gyökereken kívülre mutató szimbolikus linkeket elutasítja. Csak a szükséges médiamappát add meg, ne a teljes saját könyvtáradat. HTTP-kapcsolat nem olvashat helyi fájlt.
Hiányzó eszközöknél kapcsolódj újra a klienssel, és hasonlítsd össze profilját és kapcsolattípusát a referenciával. Ellenőrizd, hogy az eszközök betöltődtek-e az aktuális beszélgetésbe; egy mentett szervernév önmagában nem igazolja ezt.
Ossz meg hasznos diagnosztikai adatokat biztonságosan
Oszd meg a művelet nevét, időpontját, HTTP-állapotát, biztonságos hibakódját és a request_id vagy x-request-id értékét, ha van. Add meg a CLI-verziót és hogy helyi vagy távoli MCP-t használtál. Távolíts el tokeneket, sütiket, engedélyezési linkeket, aláírt média-URL-eket, ügyféltartalmat és privát azonosítókat. A releváns hibát oszd meg, ne hitelesítőadat-fájlt vagy teljes választ.