# 開發者常見問題 Canonical URL: https://sosoapi.ai/zh-hant/docs/developer-faq 直接解答 npm 別名、API／MCP 選擇、登入、媒體、安全重試、速率限制及發佈完成定義。 ## 四個 npm 套件係唔同 SDK？ 唔係。sosoapi 係正式 CLI／MCP；@sosoapi/cli、sosoapi-cli 及 sosoapi-mcp 透過別名安裝相同固定版本。揀一個就夠，唔需要四個一齊裝。 - [安裝及套件](https://sosoapi.ai/zh-hant/docs/installation) ## 應該用 HTTP、CLI 定 MCP？ 伺服器整合用 HTTP；shell automation 同 contract 檢視用 CLI；相容 assistant 用 MCP。公開 contract 邊界一致，MCP 亦提供本機上傳及組合式圖片 URL 發佈工具。伺服器憑證唔好放入前端。 - [完整 API 參考文件](https://sosoapi.ai/zh-hant/docs/api) - [MCP 工具參考文件](https://sosoapi.ai/zh-hant/docs/mcp) ## 設定或 OAuth 同意會發佈帖文？ 設定唔會發佈。授權喺選定範圍內持續有效，唔會強制每次寫入都再彈瀏覽器批准。指示 assistant 發佈前，先核對確實帳戶、內容及時間。 - [登入及權限](https://sosoapi.ai/zh-hant/docs/authentication) ## HTTP 200 或 202 代表已發佈？ 唔代表。可能只係接受請求、已排程或處理中。保存 post ID，讀取同一 Scheduled Post 及其平台確認終態；有 permalink 先顯示。每個目的地要分開報結果。 - [發佈結果](https://sosoapi.ai/zh-hant/docs/publishing-api-reference) ## 逾時後可以重試？ 先讀原有操作。Scheduled Post 保留原 ID 同確實 idempotency key。改 payload 係另一個請求；唔好為繼續已接受帖文而開新 key。重試、更新或取消要跟目前版本及操作資格。 - [安全處理錯誤](https://sosoapi.ai/zh-hant/docs/troubleshooting) ## 點解客戶端冇某個工具？ 檢查 core／full profile、連接方式及主機有冇重新載入。Core 省略管理工具，HTTP 省略本機檔案上傳；工具參考會列明。改 profile 唔會修復欠缺權限或帳戶資格。 - [MCP 工具參考文件](https://sosoapi.ai/zh-hant/docs/mcp) ## Remote MCP 可以上傳本機檔案？ 唔可以。用本機 upload tool 讀取允許目錄，或匯入可存取媒體 URL，再查狀態直到 ready。登記後 asset ID 同正式 asset URL 要一齊用；接受匯入唔代表媒體已準備好。 - [MCP 工具參考文件](https://sosoapi.ai/zh-hant/docs/mcp) ## 速率及方案限制係點？ Request schema 列出欄位、列表及分頁限制。studio-api 每 user 嘅真人登入限制為每分鐘 240 次；同一 user 嘅 machine credentials 另有每分鐘 480 次嘅獨立 bucket。遵守 429 及 Retry-After。方案配額、平台節流及個別帳戶資格係獨立限制，可能更嚴。讀取實時 billing／capability 資料，唔好將單一限制套用所有 endpoints。 - [發佈 API 限制](https://sosoapi.ai/zh-hant/docs/publishing-api-reference) ## Markdown 同 schemas 喺邊？ 每份指南、API 操作同 MCP 工具都有 .md 版本。API 目錄連結公開 JSON contract 同 OpenAPI 3.1。llms.txt 係發現目錄，llms-full.txt 包含雙語完整公開參考；只描述公開介面，唔包含客戶資料或憑證。 - [完整 API 參考文件](https://sosoapi.ai/zh-hant/docs/api) - [LLM 目錄](https://sosoapi.ai/llms.txt) ## 文件會保證搜尋排名或 AI 引用？ 唔會。可爬取 HTML、canonical URL、結構資料同 Markdown 改善可讀性及發現途徑；搜尋引擎同 AI 自行決定索引、排名及引用。成效要同工程覆蓋分開量度。