Obtenir l'historique de DM (XChat v3)

Obtenir l’historique de DM (XChat v3).

Retour à la référence API

/DM Endpoints

TwexAPI REST

POST/v3/twitter/dm-history

Autorisation API

AuthorizationBearer token · headerrequis

Jeton Bearer global pour TwexAPI. Inclus sous la forme : Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Corps de la requête

requisapplication/json

recipientstringrequis

User id, @handle, conversationId a:b, or group g....

pinstring | any

Identity PIN (default 1234).

default: "1234"

Afficher les propriétés

Any of:

string

string

any

any

countinteger | any

Max events per page (10–200, default 50).

default: 50

Afficher les propriétés

Any of:

integer

integer

any

any

allboolean | any

Follow has_more and return every page.

default: false

Afficher les propriétés

Any of:

boolean

boolean

any

any

beforestring | any

Oldest sequenceId for paging. Pass the previous page's oldest message sequence_id.

Afficher les propriétés

Any of:

string

string

any

any

cookiestringrequis

Identifiants de session ou auth_token autorisés de l'utilisateur (BYOC — Bring Your Own Cookie). Exécution proxy sans état avec zéro rétention d'identifiants. Consultez [Sécurité et Authentification](/fr/authentication#write-operations--byoc-bring-your-own-cookie) et [Comment obtenir un Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring | any

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

Afficher les propriétés

Any of:

string

string

any

any

Réponses

200Conversation messages with pagination info.

codeintegerrequis

Code d'état HTTP (200 indique le succès)

msgstringrequis

Message de réponse (ex. 'success')

dataDmHistoryV3Data | any

Données principales renvoyées par l'API

Afficher les propriétés

Any of:

DmHistoryV3Data

conversation_idstringrequis

Conversation id

has_morebooleanrequis

Whether older messages are available

messagesMessageModel[]requis

List of message objects

Afficher les propriétés

Array of MessageModel

idstringrequis

Message ID

textstringrequis

Texte du message

timestringrequis

Message time

attachmentobject | any

Message attachment

Afficher les propriétés

Any of:

object

object

any

any

attachmentsobject[] | any

XChat media attachments (v3).

Afficher les propriétés

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.

Afficher les propriétés

Any of:

string

string

any

any

sender_idstring | any

Sender ID

Afficher les propriétés

Any of:

string

string

any

any

recipient_idstring | any

ID du destinataire du message direct

Afficher les propriétés

Any of:

string

string

any

any

any

any

422Erreur de validation des paramètres

detailValidationError[]

Afficher les propriétés

Array of ValidationError

locstring | integer[]requis

Afficher les propriétés

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequis

Message de réponse (ex. 'success')

typestringrequis

inputany

ctxobject

⚡Console interactive / Tester l'APIPOST/v3/twitter/dm-history

Live Console

🌐Serveur cible :https://api.twexapi.io

● Prêt pour la production

✍️

Guide d'identification d'écriture (Clé TwexAPI + Cookie Twitter)

1. Clé TwexAPI (Bearer Token) : À renseigner sous "Autorisation API" ci-dessous pour la facturation et l'authentification.

2. Cookie Twitter : Pour les opérations d'écriture (tweet, like, etc.), renseignez le Cookie Twitter (ex : auth_token=...; ct0=...) dans le champ cookie ci-dessous.

🔑Autorisation API

Mémoriser la cléSynchroniser avec les exemples

Clé de plateforme TwexAPI Bearer TokenRequis

Clé API globale utilisée sur tous les points d'accès TwexAPI. Disponible sur la console.

📝Corps de la requêteapplication/json

recipientstring

RequisUser id, @handle, conversationId a:b, or group g....

pinstring

OptionnelIdentity PIN (default 1234).

countstring

OptionnelMax events per page (10–200, default 50).

allstring

OptionnelFollow has_more and return every page.

beforestring

OptionnelOldest sequenceId for paging. Pass the previous page's oldest message sequence_id.

cookiestringCookie Twitter / Auth Token

RequisIdentifiants de session ou auth_token autorisés de l'utilisateur (BYOC — Bring Your Own Cookie). Exécution proxy sans état avec zéro rétention d'identifiants. Consultez [Sécurité et Authentification](/fr/authentication#write-operations--byoc-bring-your-own-cookie) et [Comment obtenir un Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring

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

💡 Envoi rapide :⌘ / Ctrl+Enter

📡

暂无响应数据

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

Requête

curl -X POST "https://api.twexapi.io/v3/twitter/dm-history" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "recipient": "1928096185664843776:1989842918455291904",
  "pin": "1234",
  "count": 50,
  "all": false,
  "before": "2076684837654876160",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
}'

const response = await fetch("https://api.twexapi.io/v3/twitter/dm-history", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "recipient": "1928096185664843776:1989842918455291904",
  "pin": "1234",
  "count": 50,
  "all": false,
  "before": "2076684837654876160",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/v3/twitter/dm-history",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "recipient": "1928096185664843776:1989842918455291904",
  "pin": "1234",
  "count": 50,
  "all": False,
  "before": "2076684837654876160",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
},
)

Réponse

{
  "code": 200,
  "msg": "success",
  "data": {
    "conversation_id": "1928096185664843776:1989842918455291904",
    "has_more": true,
    "messages": [
      {
        "id": "1234567890123456789",
        "text": "Hello, how are you?",
        "time": "2024-01-01T12:00:00Z",
        "attachment": {
          "type": "image",
          "url": "https://example.com/image.jpg"
        },
        "attachments": [
          {
            "attachment_id": "cda5ccdd-af53-48a3-bdd1-5039a73aea25",
            "conversation_id": "1928096185664843776:1989842918455291904",
            "filename": "image.jpg",
            "filesize_bytes": 421299,
            "height": 1448,
            "key_version": "3",
            "media_hash_key": "blRIlZCVIO",
            "type": "image",
            "type_name": "IMAGE",
            "width": 1086
          }
        ],
        "sequence_id": "2076661179334979585",
        "sender_id": "1234567890123456789",
        "recipient_id": "1234567890123456789"
      }
    ]
  }
}

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