Enviar mensaje directo (XChat v3)

Enviar mensaje directo (XChat v3).

Volver a la referencia de API

/DM Endpoints

TwexAPI REST

POST/v3/twitter/send-dm

Autorización de API

AuthorizationBearer token · headerrequerido

Token Bearer global para TwexAPI. Incluido como: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Cuerpo de la solicitud

requeridoapplication/json

recipientstringrequerido

User id, @handle, or a group id (g...) for an existing group.

textstringrequerido

Texto del mensaje

media_urlsstring[] | any

URLs públicas de imágenes o vídeos adjuntos (máximo 4 fotos o 1 vídeo)

Mostrar propiedades

Any of:

string[]

Array of string

string

any

any

video_urlstring | any

Public http(s) URL of one video to attach (mutually exclusive with image).

Mostrar propiedades

Any of:

string

string

any

any

pinstring | any

Identity PIN (default 1234).

default: "1234"

Mostrar propiedades

Any of:

string

string

any

any

cookiestringrequerido

Credenciales de sesión o auth_token autorizadas del propio usuario (BYOC — Bring Your Own Cookie). Ejecución mediante proxy sin estado y con cero retención de credenciales. Consulta [Seguridad y Autenticación](/es/authentication#write-operations--byoc-bring-your-own-cookie) y [Cómo obtener la Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring | any

Optional HTTP proxy. Example: http://username:password@ip:port

Mostrar propiedades

Any of:

string

string

any

any

Respuestas

200A message object.

codeintegerrequerido

Código de estado HTTP (200 indica éxito)

msgstringrequerido

Mensaje de respuesta (ej. 'success')

dataMessageModel | anyrequerido

Carga de datos devuelta por el endpoint

Mostrar propiedades

Any of:

MessageModel

idstringrequerido

Message ID

textstringrequerido

Texto del mensaje

timestringrequerido

Message time

attachmentobject | any

Message attachment

Mostrar propiedades

Any of:

object

object

any

any

attachmentsobject[] | any

XChat media attachments (v3).

Mostrar propiedades

Any of:

object[]

Array of object

object

any

any

sequence_idstring | any

XChat sequence id. Use the oldest message's sequence_id as before for pagination.

Mostrar propiedades

Any of:

string

string

any

any

sender_idstring | any

Sender ID

Mostrar propiedades

Any of:

string

string

any

any

recipient_idstring | any

ID de usuario del destinatario del DM

Mostrar propiedades

Any of:

string

string

any

any

any

any

422Error de validación de parámetros

detailValidationError[]

Mostrar propiedades

Array of ValidationError

locstring | integer[]requerido

Mostrar propiedades

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequerido

Mensaje de respuesta (ej. 'success')

typestringrequerido

inputany

ctxobject

⚡Consola interactiva / Probar APIPOST/v3/twitter/send-dm

Live Console

🌐Servidor objetivo:https://api.twexapi.io

● Producción lista

✍️

Guía de credenciales de escritura (Clave TwexAPI + Cookie de Twitter)

1. Clave de TwexAPI (Bearer Token): Ingrésela en "Autorización API" abajo para facturación y autenticación.

2. Cookie de cuenta Twitter: Para operaciones de escritura (tuitear, dar me gusta, seguir), ingrese la Cookie (ej. auth_token=...; ct0=...) en el campo cookie abajo.

🔑Autorización API

Recordar claveSincronizar con código

Clave de plataforma TwexAPI Bearer TokenObligatorio

Clave API global utilizada en todos los endpoints de TwexAPI. Disponible en la consola.

📝Cuerpo de la solicitudapplication/json

recipientstring

ObligatorioUser id, @handle, or a group id (g...) for an existing group.

textstring

ObligatorioTexto del mensaje

media_urlsstring

OpcionalURLs públicas de imágenes o vídeos adjuntos (máximo 4 fotos o 1 vídeo)

video_urlstring

OpcionalPublic http(s) URL of one video to attach (mutually exclusive with image).

pinstring

OpcionalIdentity PIN (default 1234).

cookiestringCookie de Twitter / Auth Token

ObligatorioCredenciales de sesión o auth_token autorizadas del propio usuario (BYOC — Bring Your Own Cookie). Ejecución mediante proxy sin estado y con cero retención de credenciales. Consulta [Seguridad y Autenticación](/es/authentication#write-operations--byoc-bring-your-own-cookie) y [Cómo obtener la Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring

OpcionalOptional HTTP proxy. Example: http://username:password@ip:port

💡 Envío rápido:⌘ / Ctrl+Enter

📡

暂无响应数据

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

Solicitud

curl -X POST "https://api.twexapi.io/v3/twitter/send-dm" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "recipient": "baker_donn80196",
  "text": "hello from docs",
  "media_urls": [
    "https://example.com/image.jpg"
  ],
  "video_url": "https://video.twimg.com/amplify_video/2077160248830275584/vid/avc1/320x568/kwNDLTm",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
}'

const response = await fetch("https://api.twexapi.io/v3/twitter/send-dm", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "recipient": "baker_donn80196",
  "text": "hello from docs",
  "media_urls": [
    "https://example.com/image.jpg"
  ],
  "video_url": "https://video.twimg.com/amplify_video/2077160248830275584/vid/avc1/320x568/kwNDLTm",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/v3/twitter/send-dm",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "recipient": "baker_donn80196",
  "text": "hello from docs",
  "media_urls": [
    "https://example.com/image.jpg"
  ],
  "video_url": "https://video.twimg.com/amplify_video/2077160248830275584/vid/avc1/320x568/kwNDLTm",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
},
)

Respuesta

{
  "code": 200,
  "msg": "success",
  "data": {
    "attachment": {
      "type": "image",
      "url": "https://example.com/image.jpg"
    },
    "id": "1234567890123456789",
    "text": "Hello, how are you?",
    "time": "2024-01-01T12:00:00Z"
  }
}

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