跳转到主要内容
“管理 DM 屏蔽”的 endpoint 允许您代表已验证的用户屏蔽或取消屏蔽指定账号。对于这些 endpoint,有两种可用的 POST 方法:
  • /2/users/:id/dm/block:用于屏蔽账号
  • /2/users/:id/dm/unblock:用于取消屏蔽账号

快速开始

身份验证

由于你代表某位用户发起请求,必须使用 OAuth 1.0a 用户上下文OAuth 2.0 授权码模式(Authorization Code)配合 PKCE 来对这些 endpoint 进行身份验证,并使用与该用户关联的用户 Access Tokens。你可以通过 三方 OAuth 授权流程(OAuth 1.0a)或 Authorization Code with PKCE grant flow(OAuth 2.0)生成该用户的 Access Token。

发起请求

Block 用户通过你的 App 完成认证后,你即可代表该用户调用 Block endpoint,如下所示:
      curl --request POST 'https://api.x.com/2/users/:id/dm/block' --header 'Authorization: ••••••'
如果请求成功,您将看到如下所示的 JSON 响应:
{
   "data": {
       "blocked": true
   }
}
取消屏蔽 当用户已在你的 App 完成认证后,你可以按如下方式代表该用户调用 Unblock endpoint:
      curl --request POST 'https://api.x.com/2/users/:id/dm/unblock' --header 'Authorization: ••••••'
如果请求成功,您将看到如下所示的 JSON 响应:
{
   "data": {
       "blocked": false
   }
}
I