检查私信权限状态

查询用户 ID 或用户名对应的私信状态信号。请求体为字符串数组，使用服务端账号池查询。

["44196397","elonmusk"]

响应字段及已有批量、额度限制保持不变。不能仅凭 can_dm_on_xchat=false 判断普通私信无法发送，返回的状态信号也不保证实际发送成功。

即将支持：包含 users 和可选发送者 cookie 的对象请求体（{"users":[...],"cookie":"..."}）。线上 API 暂未支持，目前会返回 HTTP 422，上线前请使用上面的数组格式。

返回 API 接口列表

/DM Endpoints

TwexAPI REST

POST/v2/dm/status

API 鉴权

AuthorizationBearer token · header必填

TwexAPI 平台的全局身份凭据 (Bearer Token)。所有接口调用均需在 Header 中携带：Authorization: Bearer <YOUR_TWEXAPI_KEY>。可在 TwexAPI 用户控制台获取。

请求体

必填application/json

Any of:

string[]

Array of string

string

object

usersstring[]必填

需要查询的用户 ID 或用户名列表，数字用户 ID 请以字符串传入。

cookiestring

可选，实际发送者授权的完整 X Cookie 请求头内容或原始 auth_token。省略时使用服务端账号池。空白、null 或非字符串值无效；会话认证失败不会回退到账号池。

matches \S

响应结果

200用户私信状态及认证资料组成的列表。

codeinteger必填

HTTP 响应状态码（200 表示成功）

msgstring必填

响应提示信息（例如 'success'）

dataDMStatusModelV2[]必填

接口返回的核心业务数据载荷

展开属性

Array of DMStatusModelV2

user_idstring | any

目标用户的推特唯一数字 ID

展开属性

Any of:

string

string

any

any

screen_namestring | any

推特用户名（Handle，即 @ 后的名称）

展开属性

Any of:

string

string

any

any

is_blue_verifiedboolean | any

是否为推特蓝 V 认证用户（X Premium 会员）

展开属性

Any of:

boolean

boolean

any

any

is_verified_organization_affiliateboolean | any

展开属性

Any of:

boolean

boolean

any

any

verifiedboolean | any

是否通过推特官方实名/身份认证

展开属性

Any of:

boolean

boolean

any

any

can_dmboolean | any

当前登录账号是否允许向该用户发送私信

展开属性

Any of:

boolean

boolean

any

any

can_dm_on_xchatboolean | any

展开属性

Any of:

boolean

boolean

any

any

dm_blockingboolean | any

展开属性

Any of:

boolean

boolean

any

any

passes_premium_checkboolean | any

展开属性

Any of:

boolean

boolean

any

any

422请求参数校验错误

detailValidationError[]

展开属性

Array of ValidationError

locstring | integer[]必填

展开属性

Array of string | integer

Any of:

string

string

integer

integer

msgstring必填

响应提示信息（例如 'success'）

typestring必填

inputany

ctxobject

⚡交互式测试 / Try APIPOST/v2/dm/status

Live Console

🌐目标服务器:https://api.twexapi.io

● 生产环境就绪

🔍

公开数据读取（仅需 TwexAPI 平台密钥，无需 Twitter Cookie）

本接口为公开推特数据检索/查询，无需任何推特账号或 Cookie！仅需在下方「API 鉴权」中输入您的 TwexAPI 平台密钥 (Bearer Token) 即可直接发起测试。

🔑API 鉴权

记住密钥同步到代码示例

TwexAPI 平台密钥 Bearer Token必填

用于调用 TwexAPI 平台全部接口的全局 API 密钥，在控制台获取。

📝请求体application/json

💡 快捷发送:⌘ / Ctrl+Enter

📡

暂无响应数据

请在「请求配置」中确认参数后，点击底部的「发送请求」按钮。

请求示例

curl -X POST "https://api.twexapi.io/v2/dm/status" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  "44196397",
  "elonmusk"
]'

const response = await fetch("https://api.twexapi.io/v2/dm/status", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify([
  "44196397",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/v2/dm/status",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "44196397",
  "elonmusk"
],
)

响应示例

{
  "code": 0,
  "msg": "string",
  "data": [
    {
      "user_id": "string",
      "screen_name": "string",
      "is_blue_verified": true,
      "is_verified_organization_affiliate": true,
      "verified": true,
      "can_dm": true,
      "can_dm_on_xchat": true,
      "dm_blocking": true,
      "passes_premium_check": true
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}