检查私信权限状态

发送私信前检测目标账号是否允许接收来自未关注者的私信，避免触发滥用拦截。需附带 Twitter Cookie。

返回 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

Array of string

string

响应结果

200映射用户数字 ID 对应私信可达性状态的结果对象。

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 '[
  "1696160451770429440",
  "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([
  "1696160451770429440",
  "elonmusk"
])
});

import requests

response = requests.post(
    "https://api.twexapi.io/v2/dm/status",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json=[
  "1696160451770429440",
  "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": {}
    }
  ]
}