简介

X Activity API（XAA）端点组使开发者能够接入 X 平台上的活动事件。

开发者可以订阅感兴趣的事件，例如 ProfileBioUpdate、ProfilePictureUpdate 等，并按目标用户的用户 ID 进行筛选。与该用户 ID 匹配的事件将以亚秒级延迟投递到你的应用。

X Activity API 目前处于公开测试（开放测试）阶段。在此期间，可能会出现漏洞、破坏性变更或未完成的功能。

你的反馈至关重要——请通过我们的开发者社区论坛报告问题。

​

传送机制

X Activity API 目前支持以下机制将事件发送到你的应用：

• 持久 HTTP 流
• Webhook

​

支持的事件类型

目前，X Activity API 支持以下个人资料更新事件，如下所示：

类别	事件名称	描述
个人资料	ProfileBioUpdate	当用户更新个人简介时触发
个人资料	ProfilePictureUpdate	当用户更新个人头像时触发
个人资料	ProfileBannerUpdate	当用户更新个人横幅时触发
个人资料	ProfileGeoUpdate	当用户更新个人位置时触发
个人资料	ProfileUrlUpdate	当用户更新个人网站 URL 时触发
个人资料	ProfileScreennameUpdate	当用户更新显示名称时触发
个人资料	ProfileVerifiedBadgeUpdate	当用户更新认证徽章时触发

在后续版本中，XAA 将扩展支持更多事件类型，包括社交互动、内容互动、变现功能等。一旦有新的事件类型可用，我们将持续更新文档。

**注意：**XAA 不投递帖子。若需实时投递帖子，请参阅我们的 Filtered Stream 端点，开发者可借此实时筛选并流式获取帖子。

​

事件隐私与身份验证

X Activity API 将事件区分为公开事件和私密事件，与下文所述的 X 应用保持一致。

​

公开事件

公开事件是指公共用户账号以公开方式执行、对所有 X 用户可见的活动。这些事件在 X 平台上对所有用户可见，且无需用户进行 OAuth 认证即可查看。

当前公开事件：

• 个人资料更新（简介、头像、横幅、位置、URL、用户名变更）

对于这些公开事件，你可以在筛选条件中指定用户 ID 来创建订阅，并通过 XAA 接收相关事件。

​

私有事件

私有事件是指需要通过 OAuth 身份验证并取得用户明确同意的活动。用户必须通过 X 进行身份验证，并明确授权开发者 App 访问这些事件。

私有事件的身份验证要求：

• 用户必须通过 OAuth 2.0 验证您的应用
• 您的应用必须获取相应的 OAuth 权限范围（scopes）
• 用户必须明确授予您的应用访问这些事件的权限
• 私有事件的订阅只能为已授权您应用的用户创建

​

订阅限制

X Activity API 会根据你的账户层级设定不同的订阅上限：

套餐层级	最大订阅数
免费	不提供
基础	50
专业	2500
企业	20,000
合作伙伴	100,000

账户设置

要访问这些端点，你需要：

• 一个已获批准的开发者账户。
• 使用来自开发者 App的密钥与令牌进行身份验证，该 App 位于一个项目中。 

在我们的入门指南中了解如何获取 X API v2 端点的访问权限。