# 開發者問答

標準 URL： https://sosoapi.ai/zh-tw/docs/developer-faq

直接解答 npm 別名、API 與 MCP 選擇、身分驗證、媒體、安全重試、速率限制，以及已發布的真正含義。

## 四個 npm 套件是不同的 SDK 嗎？

不是。安裝 sosoapi 或其別名之一：@sosoapi/cli、sosoapi-cli 或 sosoapi-mcp。每個別名使用完全相同版本的 CLI 和 MCP 實作。只需安裝一個。

- [安裝與套件](https://sosoapi.ai/zh-tw/docs/installation)

## 我該使用 HTTP、CLI 還是 MCP？

在伺服器中使用 HTTP，用 CLI 進行 shell 自動化和檢查 schema，或透過相容代理程式使用 MCP。它們使用相同的公開 API 契約。MCP 還提供本機檔案上傳，以及為您處理媒體準備的圖片 URL 發布貼文工具。不要讓伺服器憑證出現在瀏覽器程式碼中。

- [完整 API 參考](https://sosoapi.ai/zh-tw/docs/api)

- [MCP 工具參考](https://sosoapi.ai/zh-tw/docs/mcp)

## 設定或 OAuth 同意會發布貼文嗎？

不會。設定不會發布任何內容。OAuth 同意會在所選範圍內授予持續存取權限，不會為每次寫入要求新的瀏覽器核准。請告知代理程式何時等待審核，並在要求發布前檢查帳號、內容和時間。

- [驗證與權限](https://sosoapi.ai/zh-tw/docs/authentication)

## HTTP 200 或 202 表示已發布嗎？

不代表。請求可能已接受、已排程或仍在處理中。請儲存貼文 ID，並讀取同一則排程貼文，直到其結果確認已發布。若可取得永久連結，請一併提供，並分別回報各目標結果。

- [發布結果](https://sosoapi.ai/zh-tw/docs/publishing-api-reference)

## 逾時後可以重試嗎？

先檢查既有操作。保留排程貼文 ID，對相同請求重複使用相同冪等鍵。變更承載內容就代表不同請求。若要重試、更新或取消既有貼文，請使用其目前版本，以及 SosoAPI 針對該狀態提供的操作。

- [安全處理錯誤](https://sosoapi.ai/zh-tw/docs/troubleshooting)

## 為什麼用戶端裡缺少某個工具？

檢查設定、連結類型以及用戶端是否已重新載入伺服器。core 隱藏管理工具；HTTP 連結不含本機檔案上傳。工具參考列出可用性。更改設定不會改變帳號權限或資格。

- [MCP 工具參考](https://sosoapi.ai/zh-tw/docs/mcp)

## 遠端 MCP 可以上傳本機檔案嗎？

不可以。請使用本機 MCP，從允許的資料夾上傳檔案，或透過 HTTP 匯入公開媒體 URL。持續檢查匯入直到就緒，再一起使用已登記素材 ID 與標準 URL。已接受的匯入仍在進行中。

- [MCP 工具參考](https://sosoapi.ai/zh-tw/docs/mcp)

## 速率與方案限制為何？

請查看每個 schema 的欄位、列表和分頁限制。studio-api 對人工工作階段允許每位使用者每分鐘 240 個請求；該使用者的機器憑證另有每分鐘 480 個請求的獨立配額桶。請遵循 429 和 Retry-After。方案配額、平台限制和帳號資格相互獨立；大量執行前請讀取目前帳務和能力資訊。

- [發布 API 限制](https://sosoapi.ai/zh-tw/docs/publishing-api-reference)

## Markdown 和 schema 在哪裡？

在指南、API 操作或 MCP 工具 URL 後加入 .md，即可取得 Markdown 版本。API 索引連結至公開 JSON 契約與 OpenAPI 3.1 文件。頁面索引請從 llms.txt 開始，兩種語言的完整參考資料請使用 llms-full.txt。這些檔案包含公開文件，不含帳號資料或憑證。

- [完整 API 參考](https://sosoapi.ai/zh-tw/docs/api)

- [LLM 索引](https://sosoapi.ai/zh-tw/llms.txt)

## 這些文件保證獲得搜尋收錄或 AI 引用嗎？

不保證。HTML 頁面、標準 URL、結構化中繼資料和 Markdown 有助於系統讀取文件。搜尋引擎和 AI 服務仍自行決定收錄、排名或引用哪些內容。請將這些結果與頁面是否可存取分開檢查。