使用時先載入搜尋資料。亦可直接瀏覽下方分類。

開發者文件

開發者常見問題

直接解答 npm 別名、API/MCP 選擇、登入、媒體、安全重試、速率限制及發佈完成定義。

閱讀 Markdown

SosoAPI 團隊核對 ·

四個 npm 套件係唔同 SDK?

唔係。sosoapi 係正式 CLI/MCP;@sosoapi/cli、sosoapi-cli 及 sosoapi-mcp 透過別名安裝相同固定版本。揀一個就夠,唔需要四個一齊裝。

應該用 HTTP、CLI 定 MCP?

伺服器整合用 HTTP;shell automation 同 contract 檢視用 CLI;相容 assistant 用 MCP。公開 contract 邊界一致,MCP 亦提供本機上傳及組合式圖片 URL 發佈工具。伺服器憑證唔好放入前端。

設定或 OAuth 同意會發佈帖文?

設定唔會發佈。授權喺選定範圍內持續有效,唔會強制每次寫入都再彈瀏覽器批准。指示 assistant 發佈前,先核對確實帳戶、內容及時間。

HTTP 200 或 202 代表已發佈?

唔代表。可能只係接受請求、已排程或處理中。保存 post ID,讀取同一 Scheduled Post 及其平台確認終態;有 permalink 先顯示。每個目的地要分開報結果。

逾時後可以重試?

先讀原有操作。Scheduled Post 保留原 ID 同確實 idempotency key。改 payload 係另一個請求;唔好為繼續已接受帖文而開新 key。重試、更新或取消要跟目前版本及操作資格。

點解客戶端冇某個工具?

檢查 core/full profile、連接方式及主機有冇重新載入。Core 省略管理工具,HTTP 省略本機檔案上傳;工具參考會列明。改 profile 唔會修復欠缺權限或帳戶資格。

Remote MCP 可以上傳本機檔案?

唔可以。用本機 upload tool 讀取允許目錄,或匯入可存取媒體 URL,再查狀態直到 ready。登記後 asset ID 同正式 asset URL 要一齊用;接受匯入唔代表媒體已準備好。

速率及方案限制係點?

Request schema 列出欄位、列表及分頁限制。studio-api 每 user 嘅真人登入限制為每分鐘 240 次;同一 user 嘅 machine credentials 另有每分鐘 480 次嘅獨立 bucket。遵守 429 及 Retry-After。方案配額、平台節流及個別帳戶資格係獨立限制,可能更嚴。讀取實時 billing/capability 資料,唔好將單一限制套用所有 endpoints。

Markdown 同 schemas 喺邊?

每份指南、API 操作同 MCP 工具都有 .md 版本。API 目錄連結公開 JSON contract 同 OpenAPI 3.1。llms.txt 係發現目錄,llms-full.txt 包含雙語完整公開參考;只描述公開介面,唔包含客戶資料或憑證。

文件會保證搜尋排名或 AI 引用?

唔會。可爬取 HTML、canonical URL、結構資料同 Markdown 改善可讀性及發現途徑;搜尋引擎同 AI 自行決定索引、排名及引用。成效要同工程覆蓋分開量度。