跳转到主要内容
管理私信屏蔽的端点允许你代表已验证用户对指定账户进行屏蔽或取消屏蔽。对于这些端点,提供以下两种 POST 方法:
  • /2/users/:id/dm/block:用于屏蔽账户
  • /2/users/:id/dm/unblock:用于取消屏蔽账户

快速开始

认证

由于你将代表某位用户发起请求,必须使用 OAuth 1.0a 用户上下文OAuth 2.0 授权码(PKCE)来对这些端点进行认证,并使用与该用户关联的用户 Access Token。你可以通过 3-legged OAuth 流程(OAuth 1.0a)或通过 Authorization Code with PKCE 授权流程(OAuth 2.0)来生成该用户的 Access Token。

发起请求

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