跳转到主要内容此版本的私信查询初始发布包含三个 GET 方法：
- GET /2/dm_conversations/with/:participant_id/dm_events - 检索与一对一会话关联的私信事件。:participant_id 路径参数是与发起此请求的已认证用户进行对话的账号的用户 ID。
- GET /2/dm_conversations/:dm_conversation_id/dm_events - 检索与特定会话 ID 关联的私信事件，由 :dm_conversation_id 路径参数指定。
- GET /2/dm_events - 检索与某个用户关联的私信事件，包含一对一和群组会话。可获取追溯至最多 30 天前的事件。
请注意，私信事件 ID 在 v1.1 与 v2（以及 X App）之间是通用的，因此可将 v1.1 中用于列出单个事件的方法与这些新的 v2 端点配合使用。另请注意，企业版和 Premium Account Activity API 支持 v2 的一对一消息，但尚不支持群组会话。
在本次发布中，支持三种事件类型，这些端点支持通过查询参数对其进行筛选：
- MessageCreate - 已创建一条消息。
- ParticipantsJoin - 有新参与者加入会话。
- ParticipantsLeave - 有参与者离开会话。
对于这些 GET 方法，用户级速率限制为每 15 分钟 300 次请求。该速率限制在这些 GET 端点之间共享。
由于你是在代表用户调用私信 v2 端点，必须使用 OAuth 1.0a 用户上下文 或 OAuth 2.0 授权码（PKCE） 进行认证，并使用已授权你的 X 应用的用户所关联的访问令牌（Access Tokens）。要使用 OAuth 1.0a 生成这些访问令牌，你可以使用 三方（3-legged）OAuth 流程。要使用 OAuth 2.0 生成用户访问令牌，你可以使用 Authorization Code with PKCE 授权流程。
账号设置
要访问这些端点，你需要：
在我们的入门指南中了解如何获取 X API v2 端点的访问权限。
