# API 参考

- [API 参考](https://sosoapi.ai/zh-hans/docs/api)：所有公开 SosoAPI 操作，包含schema、权限与示例。
- [获取仪表板计数](https://sosoapi.ai/zh-hans/docs/api/analytics-api-dashboard-ops-counts)：HTTP API：获取仪表板数量。读取仪表板操作数量。
- [请求平台洞察](https://sosoapi.ai/zh-hans/docs/api/analytics-api-provider-insights-request)：HTTP API：请求平台洞察。请求以平台为权威来源的洞察。
- [获取平台洞察状态](https://sosoapi.ai/zh-hans/docs/api/analytics-api-provider-insights-status)：HTTP API：获取平台洞察状态。读取平台洞察请求状态。
- [列出帖子留言](https://sosoapi.ai/zh-hans/docs/api/analytics-api-social-comments-query)：HTTP API：列出帖子评论。读取已发现的社交评论。
- [列出监测中的帖子](https://sosoapi.ai/zh-hans/docs/api/analytics-api-social-posts-query)：HTTP API：列出监测中的帖子。读取已探索到的社交帖子。
- [创建素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-create)：HTTP API：创建素材。登记素材元数据。
- [删除素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-delete)：HTTP API：删除素材。删除单个素材。
- [创建素材导出](https://sosoapi.ai/zh-hans/docs/api/assets-api-exports-create)：HTTP API：创建素材导出。创建素材导出证据任务。
- [获取素材导出状态](https://sosoapi.ai/zh-hans/docs/api/assets-api-exports-status)：HTTP API：获取素材导出状态。读取持久保存的素材导出状态。
- [验证素材导出](https://sosoapi.ai/zh-hans/docs/api/assets-api-exports-verify)：HTTP API：验证素材导出。任何彻底删除前，先验证素材导出。
- [获取素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-get)：HTTP API：获取素材。通过 ID 读取单个素材。
- [获取素材导入状态](https://sosoapi.ai/zh-hans/docs/api/assets-api-imports-status)：HTTP API：获取素材导入状态。读取持久化媒体导入状态。
- [导入素材 URL](https://sosoapi.ai/zh-hans/docs/api/assets-api-imports-url)：HTTP API：导入素材 URL。将明确指定的外部媒体接收任务加入队列。
- [查询素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-list)：HTTP API：查询素材。使用兼容旧版的筛选条件查询素材。
- [列出素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-list-workspace)：HTTP API：列出素材。列出工作区素材。
- [删除孤立素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-orphans-delete)：HTTP API：删除孤立素材。删除所选未登记 R2 对象。
- [列出孤立素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-orphans-list)：HTTP API：列出孤立素材。列出未登记的 R2 对象。
- [请求彻底删除素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-purges-request)：HTTP API：请求清除素材。请求受所有者权限栅栏保护的素材清除。
- [重试彻底删除素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-purges-retry)：HTTP API：重试彻底删除素材。重试符合条件且带隔离防护的彻底删除。
- [获取素材存储清单](https://sosoapi.ai/zh-hans/docs/api/assets-api-storage-inventory)：HTTP API：获取素材存储清单。读取有界的已登记/对象存储清单。
- [更新素材](https://sosoapi.ai/zh-hans/docs/api/assets-api-update)：HTTP API：更新素材。更新素材元数据。
- [完成素材上传](https://sosoapi.ai/zh-hans/docs/api/assets-api-upload-complete)：HTTP API：完成素材上传。使用已上传工作区媒体对象的已签名对象标识和幂等键，完成对象登记。
- [生成素材上传签名](https://sosoapi.ai/zh-hans/docs/api/assets-api-upload-sign)：HTTP API：生成素材上传签名。为预期的 工作区 媒体对象请求签署上传 URL。请先上传位元组，再完成登记。
- [agent 身份验证：config](https://sosoapi.ai/zh-hans/docs/api/identity-api-agent-auth-config)：HTTP API：agent 身份验证：config。agent 身份验证 config 协议。使用受支持的浏览器登录流程；绝不显示凭证。
- [agent 验证：request](https://sosoapi.ai/zh-hans/docs/api/identity-api-agent-auth-request)：HTTP API：agent 身份验证：request。agent 身份验证 request 协议。使用受支持的浏览器登录流程；绝不显示凭证。
- [agent 验证：revoke-current](https://sosoapi.ai/zh-hans/docs/api/identity-api-agent-auth-revoke-current)：HTTP API：agent 身份验证：revoke-current。agent 身份验证 revoke-current 协议。使用受支持的浏览器登录流程；绝不显示凭证。
- [agent 身份验证：session](https://sosoapi.ai/zh-hans/docs/api/identity-api-agent-auth-session)：HTTP API：agent 身份验证：session。agent 身份验证 session 协议。使用受支持的浏览器登录流程；绝不显示凭证。
- [执行社区操作](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-actions-apply)：HTTP API：执行社区操作。执行已准备的操作；检查操作状态以确定最终事实。
- [准备社区操作](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-actions-prepare)：HTTP API：准备社区操作。准备一个最终社区操作。
- [获取社区操作状态](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-actions-status)：HTTP API：获取社区操作状态。读取最终操作回执；入队不代表成功。
- [获取社区能力](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-capabilities)：HTTP API：获取社区能力。读取 Community Engagement 能力信息。
- [创建社区评论](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-comments-create)：HTTP API：创建社区留言。针对标准帖子或留言目标，将一篇确切留言加入伫列；状态不代表平台成功。
- [获取评论交付结果](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-comments-outcome)：HTTP API：获取留言交付结果。读取已确认发送、复原关系、待验证状态与未解决后续事项。
- [核对留言交付结果](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-comments-reconcile)：HTTP API：核对留言交付结果。在不重送的情况下验证结果不明的 Facebook 发送，或链接一篇已确认完全相符的替代帖子。请检查 outcome 以获取终端证明。
- [获取社区留言状态](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-comments-status)：HTTP API：获取社区留言状态。读取直接留言操作经清理的终端收据。
- [获取社区摘要](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-operations-summary)：HTTP API：获取社区摘要。读取 Community Engagement 操作摘要。
- [查询社区审核伫列](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-review-queue-query)：HTTP API：查询社区审核伫列。读取可审核留言；空白页不代表成功。
- [提交社区审核](https://sosoapi.ai/zh-hans/docs/api/community-engagement-api-reviews-submit)：HTTP API：提交社区审核。提交新的不可变审核版本。
- [获取 组织 信息](https://sosoapi.ai/zh-hans/docs/api/identity-api-agent-organization-context)：HTTP API：获取组织上下文。读取实时组织、工作区和频道权限。
- [创建 API key](https://sosoapi.ai/zh-hans/docs/api/identity-api-api-keys-create)：HTTP API：创建 API key。创建具有所选能力及可选工作区限制的 API key；密钥仅返回一次。agent 只能授予其自身授权包含的权限，有效期最长 30 天，且每份授权最多持有 25 个有效 key（API_KEY_GRANT_KEY_LIMIT）。
- [延长 API key 有效期](https://sosoapi.ai/zh-hans/docs/api/identity-api-api-keys-extend)：HTTP API：延长 API key 有效期。将 API key 到期时间延长至距今最多 365 天（agent 创建的 key 为 30 天）；超过此期限会以 API_KEY_LIFETIME_EXCEEDS_CAP 拒绝。响应会带有所套用的到期时间。
- [列出 API keys](https://sosoapi.ai/zh-hans/docs/api/identity-api-api-keys-list)：HTTP API：列出 API keys。列出不含密钥的 API-key 元数据；设置 include_authority 可获取能力和工作区限制。
- [换发 API key](https://sosoapi.ai/zh-hans/docs/api/identity-api-api-keys-renew)：HTTP API：续期 API key。创建权限和工作区限制相同的后继 API key，不破坏现有 key。
- [撤销 API key](https://sosoapi.ai/zh-hans/docs/api/identity-api-api-keys-revoke)：HTTP API：撤销 API key。撤销 API key。agent 只能撤销自己创建的 key。
- [获取计费状态](https://sosoapi.ai/zh-hans/docs/api/identity-api-billing-status)：HTTP API：获取计费状态。读取计费套餐、权益与配额信息。
- [获取商业访问权限](https://sosoapi.ai/zh-hans/docs/api/identity-api-commercial-access-status)：HTTP API：获取商业访问权限。读取工作区商业访问权限信息。
- [提交反馈](https://sosoapi.ai/zh-hans/docs/api/identity-api-feedback-submit)：HTTP API：提交反馈。提交附带归属信息的产品反馈。
- [列出工作区成员](https://sosoapi.ai/zh-hans/docs/api/identity-api-member-list)：HTTP API：列出 工作区 成员。读取成员与待处理邀请。
- [列出组织频道](https://sosoapi.ai/zh-hans/docs/api/identity-api-organization-channels-list)：HTTP API：列出组织频道。列出频道和工作区关联状态。
- [预览频道移动](https://sosoapi.ai/zh-hans/docs/api/identity-api-organization-channels-move-preview)：HTTP API：预览频道移动。在移动频道前预览阻碍事项。
- [列出组织连接](https://sosoapi.ai/zh-hans/docs/api/identity-api-organization-connections-list)：HTTP API：列出组织连接。读取组织的平台连接。
- [审核组织连接](https://sosoapi.ai/zh-hans/docs/api/identity-api-organization-connections-review)：HTTP API：审核组织连接。读取已发现、供审核的确切平台资源。
- [列出组织](https://sosoapi.ai/zh-hans/docs/api/identity-api-organization-list)：HTTP API：列出组织。列出已通过身份验证的用户可见的组织。
- [列出收件匣通知](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-inbox-list)：HTTP API：列出收件箱通知。读取已通过身份验证的用户收件箱。
- [获取通知偏好](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-notifications-get)：HTTP API：获取通知偏好。读取通知发送偏好。
- [更新通知偏好](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-notifications-update)：HTTP API：更新通知偏好。更新通知送达偏好。
- [获取用户资料](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-profile-get)：HTTP API：获取用户个人资料。读取已验证用户的个人资料。
- [生成头像上传签名](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-profile-sign-avatar-url)：HTTP API：生成头像上传签名。获取签署的头像上传 URL。
- [更新用户资料](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-profile-update)：HTTP API：更新用户资料。更新已通过身份验证的用户资料。
- [解除社交账号封锁](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-social-accounts-clear-block)：HTTP API：清除社交账号封锁。在不重试帖子的情况下清除账号冷却期。冷却期仍生效或账号达到第三次冷却时，agent 凭证会被拒绝；任何调用方每 10 分钟最多只能清除账号一次。
- [断开社交账号连接](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-social-accounts-disconnect)：HTTP API：中断社交账号链接。中断 工作区 社交账号链接。
- [列出已连接账号](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-social-accounts-list)：HTTP API：列出已连接账号。列出工作区中已连接的社交账号。
- [设置社交账号自动同步](https://sosoapi.ai/zh-hans/docs/api/identity-api-user-social-accounts-set-auto-sync)：HTTP API：设置社交账号自动同步。启用或禁用账号自动同步。
- [创建 工作区](https://sosoapi.ai/zh-hans/docs/api/identity-api-workspace-create)：HTTP API：创建 工作区。在你拥有或管理的 组织 中创建 工作区。若属于多个 组织，请传入 organization_id。
- [获取工作区上下文](https://sosoapi.ai/zh-hans/docs/api/identity-api-workspace-list)：HTTP API：获取 工作区 信息。列出 工作区 与使用中的 工作区。
- [更新 工作区](https://sosoapi.ai/zh-hans/docs/api/identity-api-workspace-update)：HTTP API：更新 工作区。更新 工作区 名称或代称。
- [获取工作状态](https://sosoapi.ai/zh-hans/docs/api/jobs-api-get)：HTTP API：获取工作状态。依 ID 读取单个工作状态。
- [列出任务](https://sosoapi.ai/zh-hans/docs/api/jobs-api-list)：HTTP API：列出工作。读取已验证用户拥有的近期工作。
- [启动 Instagram OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-instagram-init)：HTTP API：启动 Instagram OAuth。启动平台同意流程并返回原生授权 URL。
- [更新 Instagram OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-instagram-refresh)：HTTP API：更新 Instagram OAuth。更新 Instagram 连接。
- [启动 Meta OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-meta-init)：HTTP API：启动 Meta OAuth。启动平台同意流程并返回原生授权 URL。
- [刷新 Meta OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-meta-refresh)：HTTP API：更新 Meta OAuth。更新 Meta 连接。
- [检查 Threads OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-threads-check)：HTTP API：检查 Threads OAuth。读取 Threads 连接诊断。
- [启动 Threads OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-threads-init)：HTTP API：启动 Threads OAuth。启动平台同意流程并返回原生授权 URL。
- [更新 Threads OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-threads-refresh)：HTTP API：更新 Threads OAuth。更新 Threads 连接。
- [启动 YouTube OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-youtube-init)：HTTP API：启动 YouTube OAuth。启动平台同意流程并返回原生授权 URL。
- [更新 YouTube OAuth](https://sosoapi.ai/zh-hans/docs/api/oauth-api-youtube-refresh)：HTTP API：更新 YouTube OAuth。更新 YouTube 连接。
- [获取项目账号默认值](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-account-defaults-get)：HTTP API：获取项目账号默认值。读取项目账号默认值。
- [替换项目账号默认值](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-account-defaults-replace)：HTTP API：替换项目账号默认值。替换项目账号默认值。
- [关联项目账号](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-accounts-link)：HTTP API：关联项目账号。将社交账号关联到项目。
- [列出项目账号](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-accounts-list)：HTTP API：列出项目账号。列出项目关联的账号。
- [取消关联项目账号](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-accounts-unlink)：HTTP API：取消关联项目账号。解除社交账号与项目的关联。
- [归档项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-archive)：HTTP API：归档项目。归档项目但不变更其排程帖子。如需停止帖子，请另行取消该排程帖子。仅限 工作区 所有者；请传入 expected_lifecycle_version 及 idempotency_key。
- [关联项目素材](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-assets-link)：HTTP API：关联项目素材。将素材关联到项目。
- [列出项目素材](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-assets-list)：HTTP API：列出项目素材。列出关联到项目的素材。
- [取消关联项目素材](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-assets-unlink)：HTTP API：取消关联项目素材。取消素材与项目的关联。
- [创建项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-create)：HTTP API：创建项目。创建一个项目。
- [创建项目导出](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-export-create)：HTTP API：创建项目导出。创建项目导出。
- [获取项目导出状态](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-export-status)：HTTP API：获取项目导出状态。读取项目导出状态。
- [获取项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-get)：HTTP API：获取项目。读取项目。
- [获取项目生命周期历史](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-lifecycle-history)：HTTP API：获取项目生命周期历史。读取项目生命周期历史。
- [列出项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-list)：HTTP API：列出项目。列出 工作区 项目。
- [获取项目资料](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-profile-get)：HTTP API：获取项目资料。读取项目资料。
- [更新项目资料](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-profile-update)：HTTP API：更新项目资料。更新项目资料。
- [设置使用中项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-set-active)：HTTP API：设置活动项目。设置活动项目。
- [取消归档项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-unarchive)：HTTP API：取消归档项目。重新启用已归档项目。这不会恢复或重新排程帖子；请通过 Scheduled Posts 管理。仅限工作区所有者；传入 expected_lifecycle_version 和 idempotency_key。
- [更新项目](https://sosoapi.ai/zh-hans/docs/api/studio-api-projects-update)：HTTP API：更新项目。更新一个项目。
- [列出待处理发布事项](https://sosoapi.ai/zh-hans/docs/api/studio-api-publication-attentions-list)：HTTP API：列出待处理发布事项。读取需要关注的发布结果。
- [批次创建排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-bulk-create)：HTTP API：批次创建排程帖子。为多个目标创建排程帖子。
- [取消排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-cancel)：HTTP API：取消排程帖子。取消排程帖子。
- [创建排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-create)：HTTP API：创建排程帖子。创建排程帖子并检查最终发布结果。
- [提交完整图片帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-create-image-url)：HTTP API：提交完整图片帖子。持久接受一篇完整的图片 URL 帖子，并在最终结果可用时返回。
- [删除排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-delete)：HTTP API：删除排程帖子。删除排程帖子。
- [获取排程帖子资格](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-eligibility)：HTTP API：获取排程帖子资格。排程前读取目标资格。
- [获取排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-get)：HTTP API：获取排程帖子。读取单个排程帖子。
- [列出排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-list)：HTTP API：列出排程帖子。列出排程帖子。
- [立即发布排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-publish-now)：HTTP API：立即发布排程帖子。请求立即发布。
- [重试排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-retry)：HTTP API：重试排程帖子。重试失败的排程帖子。
- [更新排程帖子](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-update)：HTTP API：更新排程帖子。更新一篇排程帖子。
- [撤回删除请求](https://sosoapi.ai/zh-hans/docs/api/studio-api-scheduled-posts-withdraw-delete)：HTTP API：撤回删除请求。撤回已停止的 Instagram Login 删除请求并保留已发布帖子。
- [获取 X 发布积分](https://sosoapi.ai/zh-hans/docs/api/studio-api-x-usage)：HTTP API：获取 X 发布额度。读取 组织 共用的 X 额度，以及可选最终 Post 文字的额度费用。