# API 參考

- [API 參考](https://sosoapi.ai/zh-tw/docs/api)：所有公開 SosoAPI 操作，包含結構描述、權限與範例。
- [取得儀表板計數](https://sosoapi.ai/zh-tw/docs/api/analytics-api-dashboard-ops-counts)：HTTP API：取得儀表板數量。讀取儀表板操作數量。
- [請求平台洞察](https://sosoapi.ai/zh-tw/docs/api/analytics-api-provider-insights-request)：HTTP API：請求平台洞察。請求以平台為權威來源的洞察。
- [取得平台洞察狀態](https://sosoapi.ai/zh-tw/docs/api/analytics-api-provider-insights-status)：HTTP API：取得平台洞察狀態。讀取平台洞察請求狀態。
- [列出貼文留言](https://sosoapi.ai/zh-tw/docs/api/analytics-api-social-comments-query)：HTTP API：列出貼文留言。讀取已發現的社群留言。
- [列出監測中的貼文](https://sosoapi.ai/zh-tw/docs/api/analytics-api-social-posts-query)：HTTP API：列出監測中的貼文。讀取已探索到的社群貼文。
- [建立素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-create)：HTTP API：建立素材。登記素材中繼資料。
- [刪除素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-delete)：HTTP API：刪除素材。刪除單一素材。
- [建立素材匯出](https://sosoapi.ai/zh-tw/docs/api/assets-api-exports-create)：HTTP API：建立素材匯出。建立素材匯出證據任務。
- [取得素材匯出狀態](https://sosoapi.ai/zh-tw/docs/api/assets-api-exports-status)：HTTP API：取得素材匯出狀態。讀取持久保存的素材匯出狀態。
- [驗證素材匯出](https://sosoapi.ai/zh-tw/docs/api/assets-api-exports-verify)：HTTP API：驗證素材匯出。任何清除前，先驗證素材匯出。
- [取得素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-get)：HTTP API：取得素材。透過 ID 讀取單一素材。
- [取得素材匯入狀態](https://sosoapi.ai/zh-tw/docs/api/assets-api-imports-status)：HTTP API：取得素材匯入狀態。讀取持久保存媒體匯入狀態。
- [匯入素材 URL](https://sosoapi.ai/zh-tw/docs/api/assets-api-imports-url)：HTTP API：匯入素材 URL。將明確指定的外部媒體匯入工作加入佇列。
- [查詢素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-list)：HTTP API：查詢素材。使用相容舊版的篩選條件查詢素材。
- [列出素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-list-workspace)：HTTP API：列出素材。列出工作空間素材。
- [刪除孤立素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-orphans-delete)：HTTP API：刪除孤立素材。刪除所選未登記 R2 物件。
- [列出孤立素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-orphans-list)：HTTP API：列出孤立素材。列出未登記的 R2 物件。
- [請求清除素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-purges-request)：HTTP API：請求清除素材。請求受擁有者權限柵欄保護的素材清除。
- [重試素材清除](https://sosoapi.ai/zh-tw/docs/api/assets-api-purges-retry)：HTTP API：重試素材清除。重試符合資格且帶隔離防護的清除。
- [取得素材儲存清單](https://sosoapi.ai/zh-tw/docs/api/assets-api-storage-inventory)：HTTP API：取得素材儲存清單。讀取有範圍限制的已登記/物件儲存清單。
- [更新素材](https://sosoapi.ai/zh-tw/docs/api/assets-api-update)：HTTP API：更新素材。更新素材中繼資料。
- [完成素材上傳](https://sosoapi.ai/zh-tw/docs/api/assets-api-upload-complete)：HTTP API：完成素材上傳。使用已上傳工作空間媒體物件的已簽名物件識別和冪等鍵，完成物件登記。
- [產生素材上傳簽名](https://sosoapi.ai/zh-tw/docs/api/assets-api-upload-sign)：HTTP API：簽署素材上傳。為預期的 Workspace 媒體物件請求簽署上傳 URL。請先上傳位元組，再完成登記。
- [代理程式身分驗證：config](https://sosoapi.ai/zh-tw/docs/api/identity-api-agent-auth-config)：HTTP API：代理程式身分驗證：config。代理程式身分驗證 config 通訊協定。使用受支援的瀏覽器登入流程；絕不顯示憑證。
- [代理程式驗證：request](https://sosoapi.ai/zh-tw/docs/api/identity-api-agent-auth-request)：HTTP API：代理程式身分驗證：request。代理程式身分驗證 request 通訊協定。使用受支援的瀏覽器登入流程；絕不顯示憑證。
- [代理程式驗證：revoke-current](https://sosoapi.ai/zh-tw/docs/api/identity-api-agent-auth-revoke-current)：HTTP API：代理程式身分驗證：revoke-current。代理程式身分驗證 revoke-current 通訊協定。使用受支援的瀏覽器登入流程；絕不顯示憑證。
- [代理程式身分驗證：session](https://sosoapi.ai/zh-tw/docs/api/identity-api-agent-auth-session)：HTTP API：代理程式身分驗證：session。代理程式身分驗證 session 通訊協定。使用受支援的瀏覽器登入流程；絕不顯示憑證。
- [執行社群操作](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-actions-apply)：HTTP API：執行社群操作。執行已準備的操作；檢查操作狀態以確定最終結果。
- [準備社群操作](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-actions-prepare)：HTTP API：準備社群操作。準備一個最終社群操作。
- [取得社群操作狀態](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-actions-status)：HTTP API：取得社群操作狀態。讀取最終操作收據；加入佇列不代表成功。
- [取得社群能力](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-capabilities)：HTTP API：取得社群能力。讀取 Community Engagement 能力資訊。
- [建立社群留言](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-comments-create)：HTTP API：建立社群留言。針對標準貼文或留言目標，將一則確切留言加入佇列；狀態不代表平台成功。
- [取得留言傳送結果](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-comments-outcome)：HTTP API：取得留言傳送結果。讀取已確認傳送、復原關係、待驗證狀態與未解決後續事項。
- [核對留言傳送結果](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-comments-reconcile)：HTTP API：核對留言傳送結果。在不重送的情況下驗證結果不明的 Facebook 傳送，或連結一則已確認完全相符的替代貼文。請檢查 outcome 以取得終端證明。
- [取得社群留言狀態](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-comments-status)：HTTP API：取得社群留言狀態。讀取直接留言操作經清理的終端收據。
- [取得社群摘要](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-operations-summary)：HTTP API：取得社群摘要。讀取 Community Engagement 操作摘要。
- [查詢社群審核佇列](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-review-queue-query)：HTTP API：查詢社群審核佇列。讀取可審核留言；空白頁不代表成功。
- [提交社群審核](https://sosoapi.ai/zh-tw/docs/api/community-engagement-api-reviews-submit)：HTTP API：提交社群審核。提交新的不可變更的審核版本。
- [取得 Organization 資訊](https://sosoapi.ai/zh-tw/docs/api/identity-api-agent-organization-context)：HTTP API：取得組織資訊。讀取即時組織、工作空間和頻道權限。
- [建立 API key](https://sosoapi.ai/zh-tw/docs/api/identity-api-api-keys-create)：HTTP API：建立 API key。建立具有所選能力及選填工作空間限制的 API key；機密值僅回傳一次。代理程式只能授予其自身授權包含的權限，有效期最長 30 天，且每份授權最多持有 25 個有效 key（API_KEY_GRANT_KEY_LIMIT）。
- [延長 API key 有效期](https://sosoapi.ai/zh-tw/docs/api/identity-api-api-keys-extend)：HTTP API：延長 API key 有效期。將 API key 到期時間延長至距今最多 365 天（代理程式建立的 key 為 30 天）；超過此期限會以 API_KEY_LIFETIME_EXCEEDS_CAP 拒絕。回應會帶有所套用的到期時間。
- [列出 API keys](https://sosoapi.ai/zh-tw/docs/api/identity-api-api-keys-list)：HTTP API：列出 API keys。列出不含機密值的 API-key 中繼資料；設定 include_authority 可取得能力和工作空間限制。
- [換發 API key](https://sosoapi.ai/zh-tw/docs/api/identity-api-api-keys-renew)：HTTP API：換發 API key。建立權限和工作空間限制相同的接替 API key，不破壞現有 key。
- [撤銷 API key](https://sosoapi.ai/zh-tw/docs/api/identity-api-api-keys-revoke)：HTTP API：撤銷 API key。撤銷 API key。代理程式只能撤銷自己建立的 key。
- [取得帳務狀態](https://sosoapi.ai/zh-tw/docs/api/identity-api-billing-status)：HTTP API：取得帳務狀態。讀取帳務方案、權益與配額資訊。
- [取得商業存取權限](https://sosoapi.ai/zh-tw/docs/api/identity-api-commercial-access-status)：HTTP API：取得商業存取權限。讀取工作空間商業存取權限資訊。
- [提交回饋](https://sosoapi.ai/zh-tw/docs/api/identity-api-feedback-submit)：HTTP API：提交回饋。提交附帶歸屬資訊的產品回饋。
- [列出工作空間成員](https://sosoapi.ai/zh-tw/docs/api/identity-api-member-list)：HTTP API：列出 Workspace 成員。讀取成員與待處理邀請。
- [列出組織頻道](https://sosoapi.ai/zh-tw/docs/api/identity-api-organization-channels-list)：HTTP API：列出組織頻道。列出頻道和工作空間關聯狀態。
- [預覽頻道移動](https://sosoapi.ai/zh-tw/docs/api/identity-api-organization-channels-move-preview)：HTTP API：預覽頻道移動。在移動頻道前預覽阻礙事項。
- [列出組織連結](https://sosoapi.ai/zh-tw/docs/api/identity-api-organization-connections-list)：HTTP API：列出組織連線。讀取組織的平台連線。
- [審核組織連結](https://sosoapi.ai/zh-tw/docs/api/identity-api-organization-connections-review)：HTTP API：審核組織連結。讀取已發現、供審核的確切平台資源。
- [列出組織](https://sosoapi.ai/zh-tw/docs/api/identity-api-organization-list)：HTTP API：列出組織。列出已通過驗證的使用者可見的組織。
- [列出收件匣通知](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-inbox-list)：HTTP API：列出收件匣通知。讀取已通過驗證的使用者收件匣。
- [取得通知偏好](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-notifications-get)：HTTP API：取得通知偏好。讀取通知傳送偏好。
- [更新通知偏好](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-notifications-update)：HTTP API：更新通知偏好。更新通知送達偏好。
- [取得使用者資料](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-profile-get)：HTTP API：取得使用者個人資料。讀取已驗證使用者的個人資料。
- [產生頭像上傳簽名](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-profile-sign-avatar-url)：HTTP API：簽署頭像上傳。取得簽署的頭像上傳 URL。
- [更新使用者資料](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-profile-update)：HTTP API：更新使用者資料。更新已通過驗證的使用者資料。
- [解除社群帳號封鎖](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-social-accounts-clear-block)：HTTP API：解除社群帳號封鎖。在不重試貼文的情況下清除帳號冷卻期。冷卻期仍生效或帳號達到第三次冷卻時，代理程式憑證會被拒絕；任何呼叫端每 10 分鐘最多只能清除帳號一次。
- [斷開社群帳號連結](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-social-accounts-disconnect)：HTTP API：中斷社群帳號連結。中斷 Workspace 社群帳號連結。
- [列出已連結帳號](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-social-accounts-list)：HTTP API：列出已連結帳號。列出工作空間中已連結的社群帳號。
- [設定社群帳號自動同步](https://sosoapi.ai/zh-tw/docs/api/identity-api-user-social-accounts-set-auto-sync)：HTTP API：設定社群帳號自動同步。啟用或停用帳號自動同步。
- [建立 Workspace](https://sosoapi.ai/zh-tw/docs/api/identity-api-workspace-create)：HTTP API：建立 Workspace。在您擁有或管理的 Organization 中建立 Workspace。若屬於多個 Organizations，請傳入 organization_id。
- [取得工作空間資訊](https://sosoapi.ai/zh-tw/docs/api/identity-api-workspace-list)：HTTP API：取得 Workspace 資訊。列出 Workspaces 與使用中的 Workspace。
- [更新 Workspace](https://sosoapi.ai/zh-tw/docs/api/identity-api-workspace-update)：HTTP API：更新 Workspace。更新 Workspace 名稱或代稱。
- [取得工作狀態](https://sosoapi.ai/zh-tw/docs/api/jobs-api-get)：HTTP API：取得工作狀態。依 ID 讀取單一工作狀態。
- [列出工作](https://sosoapi.ai/zh-tw/docs/api/jobs-api-list)：HTTP API：列出工作。讀取已驗證使用者擁有的近期工作。
- [啟動 Instagram OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-instagram-init)：HTTP API：啟動 Instagram OAuth。啟動平台同意流程並回傳原生授權 URL。
- [更新 Instagram OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-instagram-refresh)：HTTP API：更新 Instagram OAuth。更新 Instagram 連線。
- [啟動 Meta OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-meta-init)：HTTP API：啟動 Meta OAuth。啟動平台同意流程並回傳原生授權 URL。
- [更新 Meta OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-meta-refresh)：HTTP API：更新 Meta OAuth。更新 Meta 連線。
- [檢查 Threads OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-threads-check)：HTTP API：檢查 Threads OAuth。讀取 Threads 連結診斷。
- [啟動 Threads OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-threads-init)：HTTP API：啟動 Threads OAuth。啟動平台同意流程並回傳原生授權 URL。
- [更新 Threads OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-threads-refresh)：HTTP API：更新 Threads OAuth。更新 Threads 連線。
- [啟動 YouTube OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-youtube-init)：HTTP API：啟動 YouTube OAuth。啟動平台同意流程並回傳原生授權 URL。
- [更新 YouTube OAuth](https://sosoapi.ai/zh-tw/docs/api/oauth-api-youtube-refresh)：HTTP API：更新 YouTube OAuth。更新 YouTube 連線。
- [取得專案帳號預設值](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-account-defaults-get)：HTTP API：取得專案帳號預設值。讀取專案帳號預設值。
- [取代專案帳號預設值](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-account-defaults-replace)：HTTP API：取代專案帳號預設值。取代專案帳號預設值。
- [關聯專案帳號](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-accounts-link)：HTTP API：連結專案帳號。將社群帳號連結至專案。
- [列出專案帳號](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-accounts-list)：HTTP API：列出專案帳號。列出專案關聯的帳號。
- [解除專案帳號連結](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-accounts-unlink)：HTTP API：解除專案帳號連結。解除社群帳號與專案的連結。
- [封存專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-archive)：HTTP API：封存專案。封存專案但不變更其排程貼文。如需停止貼文，請另行取消該排程貼文。僅限 Workspace 擁有者；請傳入 expected_lifecycle_version 及 idempotency_key。
- [關聯專案素材](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-assets-link)：HTTP API：關聯專案素材。將素材關聯到專案。
- [列出專案素材](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-assets-list)：HTTP API：列出專案素材。列出連結至專案的素材。
- [解除專案素材連結](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-assets-unlink)：HTTP API：解除專案素材連結。取消素材與專案的關聯。
- [建立專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-create)：HTTP API：建立專案。建立一個專案。
- [建立專案匯出](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-export-create)：HTTP API：建立專案匯出。建立專案匯出。
- [取得專案匯出狀態](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-export-status)：HTTP API：取得專案匯出狀態。讀取專案匯出狀態。
- [取得專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-get)：HTTP API：取得專案。讀取專案。
- [取得專案生命週期歷程](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-lifecycle-history)：HTTP API：取得專案生命週期歷程。讀取專案生命週期歷程。
- [列出專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-list)：HTTP API：列出專案。列出 Workspace 專案。
- [取得專案資料](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-profile-get)：HTTP API：取得專案設定檔。讀取專案設定檔。
- [更新專案設定檔](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-profile-update)：HTTP API：更新專案資料。更新專案資料。
- [設定使用中專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-set-active)：HTTP API：設定使用中專案。設定使用中專案。
- [取消封存專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-unarchive)：HTTP API：取消封存專案。重新啟用已封存專案。這不會復原或重新排程貼文；請透過排程貼文管理。僅限工作空間擁有者；傳入 expected_lifecycle_version 和 idempotency_key。
- [更新專案](https://sosoapi.ai/zh-tw/docs/api/studio-api-projects-update)：HTTP API：更新專案。更新一個專案。
- [列出待處理發布事項](https://sosoapi.ai/zh-tw/docs/api/studio-api-publication-attentions-list)：HTTP API：列出待處理發布事項。讀取需要關注的發布結果。
- [批次建立排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-bulk-create)：HTTP API：批次建立排程貼文。為多個目標建立排程貼文。
- [取消排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-cancel)：HTTP API：取消排程貼文。取消排程貼文。
- [建立排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-create)：HTTP API：建立排程貼文。建立排程貼文並檢查終端發布結果。
- [提交完整圖片貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-create-image-url)：HTTP API：提交完整圖片貼文。持久接受一則完整的圖片 URL 貼文，並在最終結果可用時回傳。
- [刪除排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-delete)：HTTP API：刪除排程貼文。刪除排程貼文。
- [取得排程貼文資格](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-eligibility)：HTTP API：取得排程貼文資格。排程前讀取目標資格。
- [取得排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-get)：HTTP API：取得排程貼文。讀取單一排程貼文。
- [列出排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-list)：HTTP API：列出排程貼文。列出排程貼文。
- [立即發布排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-publish-now)：HTTP API：立即發布排程貼文。請求立即發布。
- [重試排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-retry)：HTTP API：重試排程貼文。重試失敗的排程貼文。
- [更新排程貼文](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-update)：HTTP API：更新排程貼文。更新一則排程貼文。
- [撤回刪除請求](https://sosoapi.ai/zh-tw/docs/api/studio-api-scheduled-posts-withdraw-delete)：HTTP API：撤回刪除請求。撤回已停止的 Instagram Login 刪除請求並保留已發布貼文。
- [取得 X 發布額度](https://sosoapi.ai/zh-tw/docs/api/studio-api-x-usage)：HTTP API：取得 X 發布額度。讀取 Organization 共用的 X 額度，以及選填最終 Post 文字的額度費用。