使用時先載入搜尋資料。亦可直接瀏覽下方分類。
SosoAPI · Developer docs
API 參考文件
107 個可呼叫操作及 4 個登入初始化 endpoints。每項操作包括正式 schema 及授權邊界。
帳戶及工作空間
- 讀取組織權限背景
POST /identity-api/agent/organization-contextRead live Organization, Workspace, and Channel authority. - 建立 API key
POST /identity-api/api-keys/createCreate an API key with chosen capabilities and optional Workspace limits; the secret is returned once. An agent can grant only what its own authorization holds, for at most 30 days, and one authorization can hold at most 25 active keys (API_KEY_GRANT_KEY_LIMIT). - 延長 API key 有效期
POST /identity-api/api-keys/extendExtend an API key expiry to at most 365 days from now (30 for a key an agent created); a later time is refused with API_KEY_LIFETIME_EXCEEDS_CAP. The response carries the expiry applied. - 列出 API keys
POST /identity-api/api-keys/listList API-key metadata without secrets; set include_authority for capabilities and Workspace limits. - 建立接替 API key
POST /identity-api/api-keys/renewCreate a non-destructive successor API key with the same capabilities and Workspace limits. - 撤銷 API key
POST /identity-api/api-keys/revokeRevoke an API key. An agent can revoke only keys it created. - 讀取方案及配額狀態
POST /identity-api/billing/statusRead billing plan, entitlement, and quota facts. - 讀取工作空間商業資格
POST /identity-api/commercial-access/statusRead Workspace commercial access facts. - 提交產品意見
POST /identity-api/feedback/submitSubmit product feedback with attribution. - 列出工作空間成員
POST /identity-api/member/listRead members and pending invites. - 列出組織頻道
POST /identity-api/organization/channels/listList channels and Workspace attachment state. - 預覽頻道搬移限制
POST /identity-api/organization/channels/move/previewPreview blockers before moving a channel. - 列出組織平台連接
POST /identity-api/organization/connections/listRead organization provider connections. - 檢視組織連接資源
POST /identity-api/organization/connections/reviewRead the exact provider resources discovered for review. - 列出組織
POST /identity-api/organization/listList organizations visible to the authenticated user. - 列出收件箱通知
POST /identity-api/user/inbox/listRead the authenticated user inbox. - 讀取通知偏好
POST /identity-api/user/notifications/getRead notification delivery preferences. - 更新通知偏好
POST /identity-api/user/notifications/updateUpdate notification delivery preferences. - 讀取個人資料
POST /identity-api/user/profile/getRead the authenticated user profile. - 取得頭像上傳 URL
POST /identity-api/user/profile/sign-avatar-urlGet a signed avatar upload URL. - 更新個人資料
POST /identity-api/user/profile/updateUpdate the authenticated user profile. - 解除社交帳戶冷卻封鎖
POST /identity-api/user/social-accounts/clear-blockClear an account cooldown without retrying a post. An agent credential is refused while the cooldown is still active or once the account reached its third cooldown; any caller can clear an account at most once every 10 minutes. - 中斷社交帳戶連接
POST /identity-api/user/social-accounts/disconnectDisconnect a Workspace social account. - 列出已連接帳戶
POST /identity-api/user/social-accounts/listList connected social accounts in a Workspace. - 設定社交帳戶自動同步
POST /identity-api/user/social-accounts/set-auto-syncEnable or disable account auto-sync. - 建立工作空間
POST /identity-api/workspace/createCreate a Workspace in an Organization you own or administer. Pass organization_id when you belong to multiple Organizations. - 讀取工作空間背景
POST /identity-api/workspace/listList Workspaces and the active Workspace. - 更新工作空間
POST /identity-api/workspace/updateUpdate Workspace name or slug.
媒體及素材
- 登記素材
POST /assets-api/createRegister asset metadata. - 刪除素材
POST /assets-api/deleteDelete one asset. - 建立素材匯出
POST /assets-api/exports/createCreate an asset export evidence job. - 讀取素材匯出狀態
POST /assets-api/exports/statusRead durable asset export status. - 驗證素材匯出
POST /assets-api/exports/verifyVerify an asset export before any purge. - 讀取素材
POST /assets-api/getRead one asset by ID. - 讀取素材匯入狀態
POST /assets-api/imports/statusRead durable media import status. - 由 URL 匯入素材
POST /assets-api/imports/urlQueue explicit external media intake. - 查詢素材
POST /assets-api/listQuery assets with legacy-compatible filters. - 列出工作空間素材
POST /assets-api/list-workspaceList Workspace assets. - 刪除未登記儲存物件
POST /assets-api/orphans/deleteDelete selected unregistered R2 objects. - 列出未登記儲存物件
POST /assets-api/orphans/listList unregistered R2 objects. - 請求清除素材
POST /assets-api/purges/requestRequest owner-fenced asset purge. - 重試素材清除
POST /assets-api/purges/retryRetry an eligible fenced purge. - 讀取素材儲存清單
POST /assets-api/storage/inventoryRead bounded registered/object storage inventory. - 更新素材資料
POST /assets-api/updateUpdate asset metadata. - 完成素材上傳登記
POST /assets-api/upload/completeComplete registration of the uploaded Workspace media object using its signed object identity and idempotency key. - 取得素材上傳簽署 URL
POST /assets-api/upload/signRequest a signed upload URL for the intended Workspace media object. Upload the bytes before completing registration.
專案及內容
- 讀取專案帳戶預設
POST /studio-api/projects/account-defaults/getRead project account defaults. - 取代專案帳戶預設
POST /studio-api/projects/account-defaults/replaceReplace project account defaults. - 連結專案帳戶
POST /studio-api/projects/accounts/linkLink a social account to a project. - 列出專案帳戶
POST /studio-api/projects/accounts/listList accounts linked to a project. - 解除專案帳戶連結
POST /studio-api/projects/accounts/unlinkUnlink a social account from a project. - 封存專案
POST /studio-api/projects/archiveArchive a project without changing its Scheduled Posts. To stop a post, cancel that Scheduled Post separately. Workspace owner only; pass expected_lifecycle_version and an idempotency_key. - 連結專案素材
POST /studio-api/projects/assets/linkLink an asset to a project. - 列出專案素材
POST /studio-api/projects/assets/listList assets linked to a project. - 解除專案素材連結
POST /studio-api/projects/assets/unlinkUnlink an asset from a project. - 建立專案
POST /studio-api/projects/createCreate a project. - 建立專案匯出
POST /studio-api/projects/export/createCreate a project export. - 讀取專案匯出狀態
POST /studio-api/projects/export/statusRead project export status. - 讀取專案
POST /studio-api/projects/getRead a project. - 讀取專案歷史
POST /studio-api/projects/lifecycle/historyRead project lifecycle history. - 列出專案
POST /studio-api/projects/listList Workspace projects. - 讀取專案內容設定
POST /studio-api/projects/profile/getRead a project profile. - 更新專案內容設定
POST /studio-api/projects/profile/updateUpdate a project profile. - 設定目前專案
POST /studio-api/projects/set-activeSet the active project. - 取消封存專案
POST /studio-api/projects/unarchiveReactivate an archived project. This does not resume or reschedule posts; manage those through Scheduled Posts. Workspace owner only; pass expected_lifecycle_version and an idempotency_key. - 更新專案
POST /studio-api/projects/updateUpdate a project. - 列出需要處理嘅發佈結果
POST /studio-api/publication-attentions/listRead publication outcomes requiring attention.
排程及發佈
- 批次建立排程帖文
POST /studio-api/scheduled-posts/bulk-createCreate scheduled posts for multiple destinations. - 取消排程帖文
POST /studio-api/scheduled-posts/cancelCancel a scheduled post. - 建立排程帖文
POST /studio-api/scheduled-posts/createCreate a scheduled post and inspect terminal publication outcome. - 提交完整圖片帖文
POST /studio-api/scheduled-posts/create-image-urlAccept one complete image URL post durably and return its terminal result when available. - 刪除排程帖文
POST /studio-api/scheduled-posts/deleteDelete a scheduled post. - 讀取排程資格
POST /studio-api/scheduled-posts/eligibilityRead destination eligibility before scheduling. - 讀取排程帖文
POST /studio-api/scheduled-posts/getRead one scheduled post. - 列出排程帖文
POST /studio-api/scheduled-posts/listList scheduled posts. - 請求立即發佈
POST /studio-api/scheduled-posts/publish-nowRequest immediate publication. - 重試失敗帖文
POST /studio-api/scheduled-posts/retryRetry a failed scheduled post. - 更新排程帖文
POST /studio-api/scheduled-posts/updateUpdate a scheduled post. - 撤回刪除請求
POST /studio-api/scheduled-posts/withdraw-deleteWithdraw a stopped Instagram Login deletion request and retain the published post. - 讀取 X 發佈額度
POST /studio-api/x/usageRead shared Organization X credits and the credit cost of optional final Post text.
分析及洞察
- 讀取儀表板操作數量
POST /analytics-api/dashboard/ops-countsRead dashboard operational counts. - 請求平台洞察數據
POST /analytics-api/provider-insights/requestRequest provider-authoritative insights. - 讀取洞察請求狀態
POST /analytics-api/provider-insights/statusRead provider insight request status. - 列出帖文留言
POST /analytics-api/social/comments/queryRead discovered social comments. - 列出已追蹤帖文
POST /analytics-api/social/posts/queryRead discovered social posts.
社交帳戶連接
- 開始 Instagram 授權
POST /oauth-api/instagram/initStart provider consent and return the native authorization URL. - 更新 Instagram 連接
POST /oauth-api/instagram/refreshRefresh an Instagram connection. - 開始 Meta 授權
POST /oauth-api/meta/initStart provider consent and return the native authorization URL. - 更新 Meta 連接
POST /oauth-api/meta/refreshRefresh a Meta connection. - 檢查 Threads 連接
POST /oauth-api/threads/checkRead Threads connection diagnostics. - 開始 Threads 授權
POST /oauth-api/threads/initStart provider consent and return the native authorization URL. - 更新 Threads 連接
POST /oauth-api/threads/refreshRefresh a Threads connection. - 開始 YouTube 授權
POST /oauth-api/youtube/initStart provider consent and return the native authorization URL. - 更新 YouTube 連接
POST /oauth-api/youtube/refreshRefresh a YouTube connection.
背景操作
留言及社群
- 執行已準備社群操作
POST /community-engagement-api/actions/applyApply a prepared action; inspect action status for terminal truth. - 準備社群操作
POST /community-engagement-api/actions/preparePrepare a terminal community action. - 讀取社群操作狀態
POST /community-engagement-api/actions/statusRead terminal action receipt; enqueue is not success. - 讀取社群功能資格
POST /community-engagement-api/capabilitiesRead Community Engagement capability facts. - 建立社群留言
POST /community-engagement-api/comments/createQueue one exact comment against a canonical post or comment target; status is not provider success. - 讀取留言傳送結果
POST /community-engagement-api/comments/outcomeRead confirmed delivery, recovery lineage, pending verification and unresolved follow-up. - 核對未明留言結果
POST /community-engagement-api/comments/reconcileVerify an ambiguous Facebook delivery without resending, or link one confirmed exact replacement. Inspect outcome for terminal proof. - 讀取留言操作狀態
POST /community-engagement-api/comments/statusRead the sanitized terminal receipt for a direct comment action. - 讀取社群操作摘要
POST /community-engagement-api/operations/summaryRead Community Engagement operational summary. - 查詢待審核留言
POST /community-engagement-api/review-queue/queryRead reviewable comments; an empty page is not success. - 提交留言審核
POST /community-engagement-api/reviews/submitSubmit a new immutable review version.
登入初始化
- 讀取 agent 登入設定
POST /identity-api/agent-auth/configAgent authentication config protocol. Use the supported browser sign-in flow; never display credentials. - 建立 agent 登入請求
POST /identity-api/agent-auth/requestAgent authentication request protocol. Use the supported browser sign-in flow; never display credentials. - 撤銷目前 agent 登入
POST /identity-api/agent-auth/revoke-currentAgent authentication revoke-current protocol. Use the supported browser sign-in flow; never display credentials. - 換取 agent 登入 session
POST /identity-api/agent-auth/sessionAgent authentication session protocol. Use the supported browser sign-in flow; never display credentials.