跳转到主要内容
私信用于在 X 上进行私人对话，是 X 最受欢迎的功能之一，拥有多种使用场景，既包括朋友间的群聊，也可用于为全球品牌提供客户支持。新的 v2 版私信 endpoints 将分阶段推出，第一阶段包含用于创建私信和列出私信会话事件的基础 endpoints。X API v2 首次支持群组对话。 Manage Direct Messages 的初始版本提供三个用于创建私信的 POST 方法：
  • POST /2/dm_conversations/with/:participant_id/messages - 创建一对一私信。该方法会创建一个新的 1-1 会话，或获取当前会话并将此私信添加到其中。:participant_id 路径参数为消息接收账户的 User ID。
  • POST /2/dm_conversations - 创建一个新的群组会话并向其中添加一条私信。请求需提供会话参与者列表。请注意，你可以使用相同的参与者列表创建多个会话，这类请求将始终返回一个新的会话 ID。
  • POST /2/dm_conversations/:dm_conversation_id/messages - 创建一条私信并将其添加到现有会话中。:dm_conversation_id 路径参数为将添加消息的会话 ID。
请注意，私信事件 ID 在 v1.1 与 v2（以及 X App）之间通用，因此可以将 v1.1 的隐藏/DELETE 私信方法与新的 v2 endpoint 搭配使用。另请注意，Enterprise 和 Premium Account Activity APIs 支持 v2 的一对一消息，但尚不支持群组对话。 对于 POST 方法，用户级请求速率限制为每 15 分钟 200 次；另有每位用户每 24 小时 1000 次的限制；此外，每 24 小时还有 15000 次的限制。请注意，这些请求速率限制在上述 POST endpoints 之间共享。 由于你是在代表用户使用 manage Posts endpoints 发起请求，必须通过 OAuth 1.0a 用户上下文或 OAuth 2.0 授权码模式（Authorization Code）配合 PKCE 进行认证，并使用与已授权你 App 的用户关联的用户 Access Tokens。若使用 OAuth 1.0a 生成用户 Access Token，可采用三方 OAuth 授权流程。若使用 OAuth 2.0 生成用户 Access Token，可采用Authorization Code with PKCE 授权流程)。
账户设置访问这些 endpoints，你需要：在我们的入门指南中了解如何获取 X API v2 endpoints 的访问权限。
⌘I