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