Fejlesztői dokumentáció
Fejlesztői kérdések és válaszok
Közvetlen válaszok az npm-aliasokról, API/MCP-választásról, hitelesítésről, médiáról, biztonságos újrapróbálásról, hívási korlátokról és a közzététel valódi jelentéséről.
Olvasás Markdown formátumbanEllenőrizte a SosoAPI csapata ·
A négy npm-csomag különböző SDK?
Nem. Telepítsd a sosoapi csomagot vagy valamelyik aliasát: @sosoapi/cli, sosoapi-cli vagy sosoapi-mcp. Minden alias ugyanazt a pontos CLI- és MCP-megvalósítási verziót használja. Csak egyre van szükséged.
HTTP-t, CLI-t vagy MCP-t használjak?
A szerveredről HTTP-t, shell-automatizáláshoz és sémavizsgálathoz CLI-t, kompatibilis ügynökkel MCP-t használj. Ugyanazokat a nyilvános API-szerződéseket használják. Az MCP helyi fájlfeltöltést és a média-előkészítést elvégző kép-URL-es közzétételi eszközt is ad. A szerverhitelesítő adatok ne kerüljenek böngészőkódba.
A beállítás vagy OAuth-hozzájárulás közzétesz bejegyzést?
Nem. A beállítás nem tesz közzé semmit. Az OAuth-hozzájárulás folyamatos hozzáférést ad a választott hatókörben, minden írás előtti új böngészős jóváhagyás nélkül. Mondd meg az ügynöknek, mikor várjon ellenőrzésre, és közzététel kérése előtt nézd meg a fiókot, tartalmat és időpontot.
A HTTP 200 vagy 202 azt jelenti, hogy közzétéve?
Nem. A kérés elfogadott, időzített vagy még feldolgozás alatt lehet. Mentsd el a bejegyzésazonosítót, és ugyanazt a Scheduled Post bejegyzést olvasd, amíg az eredmény nem igazolja a közzétételt. Ha van, add meg a permalinket, és célhelyenként külön jelentsd az eredményt.
Időtúllépés után újrapróbálhatom?
Előbb ellenőrizd a meglévő műveletet. Őrizd meg a Scheduled Post azonosítóját, és ugyanahhoz a kéréshez ugyanazt az idempotenciakulcsot használd. A megváltozott payload másik kérés. Meglévő bejegyzés újrapróbálásához, frissítéséhez vagy visszavonásához az aktuális verzióját és az adott állapothoz kínált SosoAPI-műveletet használd.
Miért hiányzik egy eszköz a kliensből?
Ellenőrizd a profilt, kapcsolattípust és azt, újratöltötte-e a kliens a szervert. A core elrejti az adminisztrációs eszközöket; a HTTP-kapcsolatokban nincs helyi fájlfeltöltés. Az elérhetőséget az eszközreferencia sorolja fel. A profilváltás nem változtat fiókengedélyt vagy jogosultságot.
A távoli MCP feltölthet helyi fájlt?
Nem. Helyi MCP-vel engedélyezett mappából tölthetsz fel fájlt, vagy HTTP-n át nyilvános média-URL-t importálhatsz. Ellenőrizd az importot készenlétig, majd együtt használd a regisztrált médiaazonosítót és kanonikus URL-t. Az elfogadott import még folyamatban van.
Milyen hívási és csomagkorlátok vannak?
Minden sémánál ellenőrizd a mezők, listák és lapozás korlátait. A studio-api felhasználónként percenként 240 kérést enged az emberi munkamenetekhez; ugyanannak a felhasználónak a gépi hitelesítő adatai külön, percenként 480-as keretet kapnak. Kövesd a 429 és Retry-After jelzéseket. A csomagkvóták, szolgáltatói korlátok és fiókjogosultságok különállók; nagy futtatás előtt olvasd el az aktuális számlázási és képességadatokat.
Hol található a Markdown és a séma?
A Markdown-változathoz adj .md végződést az útmutató, API-művelet vagy MCP-eszköz URL-jéhez. Az API-index hivatkozik a nyilvános JSON-szerződésre és az OpenAPI 3.1 dokumentumra. Oldalindexhez a llms.txt, teljes kétnyelvű referenciához a llms-full.txt a kezdőpont. E fájlok nyilvános dokumentációt tartalmaznak, nem fiókadatot vagy hitelesítő adatot.
Garantálja ez a dokumentáció a keresési vagy AI-hivatkozásokat?
Nem. A HTML-oldalak, kanonikus URL-ek, strukturált metaadatok és Markdown segítik a dokumentáció olvasását. A keresők és AI-szolgáltatók továbbra is maguk választják meg, mit indexelnek, rangsorolnak vagy idéznek. Ezeket az eredményeket az oldalak elérhetőségétől külön ellenőrizd.