跳转到主要内容
此 Direct Messages 查询功能的初始版本包含三个 GET 方法：
  • GET /2/dm_conversations/with/:participant_id/dm_events - 获取与一对一会话相关的 Direct Message 事件。:participant_id 路径参数是与发起此请求的已认证用户进行会话的账户的用户 ID。
  • GET /2/dm_conversations/:dm_conversation_id/dm_events - 获取与特定会话 ID 相关的 Direct Message 事件，由 :dm_conversation_id 路径参数指示。
  • GET /2/dm_events - 获取与某个用户相关的 Direct Message 事件，包括一对一和群组会话。可获取追溯至最多 30 天前的事件。
请注意，Direct Message 事件 ID 在 v1.1 和 v2（以及 X App）之间通用，因此可以将 v1.1 中用于列出单个事件的方法与这些新的 v2 endpoints 一起使用。另外请注意，Enterprise 和 Premium 的 Account Activity APIs 支持 v2 的一对一消息，但目前尚不支持群组会话。 在此版本中支持三种事件类型，这些 endpoints 支持通过查询参数对其进行筛选：
  • MessageCreate - 已创建一条消息。
  • ParticipantsJoin - 有新参与者加入了会话。
  • ParticipantsLeave - 有参与者离开了会话。
对于这些 GET 方法，用户的请求速率限制为每 15 分钟 300 次。此请求速率限制在这些 GET endpoints 之间共享。 由于您是在使用 Direct Message v2 endpoints 代表某位用户发起请求，您必须使用 OAuth 1.0a User Context 或 OAuth 2.0 Authorization Code with PKCE 进行身份验证，并使用已授权您的 X App 的用户所关联的 Access Tokens。要使用 OAuth 1.0a 生成这些 Access Tokens，您可以使用 3-legged OAuth flow。要使用 OAuth 2.0 为用户生成 Access Tokens，您可以使用 Authorization Code with PKCE grant flow。 账户设置 要访问这些 endpoints，您需要： 在我们的入门指南中了解更多关于获取 X API v2 endpoints 访问权限的信息。
⌘I