跳转到主要内容X 致力于支持使用 X API 构建产品的开发者社区。作为这一承诺的一部分,我们的目标是让 API 对开发者开放且公平、对 X 上的用户安全,并让整个 X 平台受益。对于任何离线存储 X 内容的开发者,确保数据能够反映用户意图以及 X 上内容的当前状态至关重要。举例来说,当有人在 X 上删除了某条 Post 或其账号、将其 Post 设为受保护,或从其 Post 中移除地理信息时,X 和我们的开发者都必须尊重该用户的期望与意图。批量合规端点为开发者提供了简便工具,帮助维护符合 X Developer Agreement and Policy 的 X 数据。
这些批量合规端点允许你上传包含 Post 或用户 ID 的大型数据集,以检索其合规状态,从而确定需要采取哪些操作使你的数据集达到合规。请注意,批量合规端点的使用仅限上述用例,任何其他用途均被禁止,并可能导致执法措施。
通常,使用此端点包含 4 个步骤:
-
创建合规作业
你可以指定作业类型(值为 tweets 或 users,用于指示你要上传的数据集包含 Post ID 还是用户 ID)。在任意时间,你每种作业类型最多可有一个并发作业。
-
将数据集上传到 upload_url
接着,将你的数据集作为纯文本文件上传到提供的 upload_url,文件的每一行包含一个 Post ID 或用户 ID。upload_url 将在 15 分钟后过期。
-
(可选)检查作业状态
你可以检查合规作业的状态,以查看其是 created、in_progress、failed 还是 complete。
-
下载结果
当作业完成后,你可以使用 download_url 下载结果。download_url 将在一周后(自作业创建起)过期。
结果将包含一组 JSON 对象(每行一个对象)。每个对象将包含一个 Post ID、该 Post 的创建日期(有助于按日期定位 Post)、所需操作、合规操作的原因,以及用户被停权的日期。
你将在结果中收到以下合规事件类型:
- deleted - 表示该 Post 或用户账号已被删除
- deactivated - 表示该 Post 或用户账号已被停用
- scrub_geo - 表示与该 Post 或用户关联的地理信息已被移除
- protected - 表示发布该 Post 的账号变为私密
- suspended - 表示发布该 Post 的账号已被停权
账号设置
要访问这些端点,你需要:
在我们的 getting started guide 中了解更多关于获取 X API v2 端点访问权限的信息。