DM 수신 권한 확인

사용자 ID 또는 사용자 이름의 DM 상태 신호를 조회합니다. 요청 본문은 문자열 배열이며, 서비스가 관리하는 계정으로 조회합니다.

["44196397","elonmusk"]

응답 필드와 기존 배치 및 크레딧 제한은 유지됩니다. can_dm_on_xchat=false만으로 일반 DM 전송이 불가능하다고 판단할 수 없으며 반환된 신호는 실제 전송 성공을 보장하지 않습니다.

지원 예정: users와 선택적인 발신자 cookie가 포함된 객체 요청 본문({"users":[...],"cookie":"..."}). 아직 운영 API에서 지원되지 않으며 현재 HTTP 422를 반환합니다. 지원 전까지는 위의 배열 형식을 사용하세요.

API 참조로 돌아가기

/DM Endpoints

TwexAPI REST

POST/v2/dm/status

API 인증

AuthorizationBearer token · header필수

TwexAPI 전역 인증 토큰 (Bearer Token). 헤더에 포함되어야 합니다: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

요청 본문

필수application/json

Any of:

string[]

Array of string

string

object

usersstring[]필수

조회할 사용자 ID 또는 사용자 이름 목록입니다. 숫자 ID도 문자열로 입력하세요.

cookiestring

선택 사항: 발신자가 승인한 X Cookie 헤더 전체 값 또는 원본 auth_token. 생략하면 서비스 관리 계정을 사용합니다. 공백, null, 문자열이 아닌 값은 유효하지 않으며 인증 실패 시 계정 풀로 전환하지 않습니다.

matches \S

응답

200사용자 DM 상태와 인증 메타데이터 목록입니다.

codeinteger필수

HTTP 상태 코드 (200은 성공)

msgstring필수

응답 메시지 (예: 'success')

dataDMStatusModelV2[]필수

엔드포인트가 반환한 핵심 데이터

속성 표시

Array of DMStatusModelV2

user_idstring | any

트위터 사용자 고유 ID

속성 표시

Any of:

string

string

any

any

screen_namestring | any

트위터 사용자명 (@ 제외)

속성 표시

Any of:

string

string

any

any

is_blue_verifiedboolean | any

속성 표시

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

⚡대화형 콘솔 / API 테스트POST/v2/dm/status

Live Console

🌐대상 서버:https://api.twexapi.io

● 프로덕션 준비 완료

🔍

공개 데이터 조회 (TwexAPI 키만 필요, Twitter 쿠키 불필요)

이 엔드포인트는 공개 Twitter 데이터를 조회합니다. Twitter 계정이나 쿠키가 필요하지 않습니다! 아래 "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": {}
    }
  ]
}