DM Medya Dosyalarını Getir

DM Medya Dosyalarını Getir.

API Belgelerine Dön

/DM Endpoints

TwexAPI REST

POST/v3/twitter/dm-media

API Yetkilendirmesi

AuthorizationBearer token · headerzorunlu

TwexAPI genel Bearer Token kimlik bilgisi. İstek başlığı: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

İstek Gövdesi

zorunluapplication/json

conversation_idstringzorunlu

Conversation id from /v3/twitter/dm-history

media_hash_keystringzorunlu

Attachment media_hash_key from dm-history

key_versionstring | any

Optional message key_version from dm-history (recommended).

Özellikleri göster

Any of:

string

string

any

any

type_namestring | any

Optional IMAGE/VIDEO/GIF hint

Özellikleri göster

Any of:

string

string

any

any

filenamestring | any

Optional filename hint

Özellikleri göster

Any of:

string

string

any

any

pinstring | any

Identity PIN (default 1234).

default: "1234"

Özellikleri göster

Any of:

string

string

any

any

cookiestringzorunlu

Kullanıcının kendi yetkilendirilmiş Twitter oturum kimlik bilgileri veya auth_token (BYOC — Bring Your Own Cookie). Sıfır kimlik bilgisi saklama ile durum bilgisi olmayan proxy yürütmesi. [Kimlik Doğrulama Güvenliği](/tr/authentication#write-operations--byoc-bring-your-own-cookie) ve [Cookie Nasıl Alınır](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie) sayfasına bakın.

proxystring | any

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

Özellikleri göster

Any of:

string

string

any

any

Yanıtlar

200Playable media URL and metadata.

codeintegerzorunlu

HTTP durum kodu (200 başarılı anlamına gelir)

msgstringzorunlu

Yanıt mesajı (örn: 'success')

dataGetDmMediaV3Data | any

Uç nokta tarafından döndürülen ana veri

Özellikleri göster

Any of:

GetDmMediaV3Data

urlstringzorunlu

Playable media URL

pathstringzorunlu

Media path on this API

content_typestringzorunlu

MIME type

filenamestring | any

Suggested filename

Özellikleri göster

Any of:

string

string

any

any

byte_lengthintegerzorunlu

File size in bytes

cachedbooleanzorunlu

Whether the media was already available

any

any

422Parametre Doğrulama Hatası

detailValidationError[]

Özellikleri göster

Array of ValidationError

locstring | integer[]zorunlu

Özellikleri göster

Array of string | integer

Any of:

string

string

integer

integer

msgstringzorunlu

Yanıt mesajı (örn: 'success')

typestringzorunlu

inputany

ctxobject

⚡Etkileşimli Konsol / API TestiPOST/v3/twitter/dm-media

Live Console

🌐Hedef Sunucu:https://api.twexapi.io

● Canlı Ortam Hazır

✍️

Yazma İşlemi Kimlik Kılavuzu (TwexAPI Anahtarı + Twitter Çerezi)

1. TwexAPI Anahtarı (Bearer Token): İstek faturalandırması ve kimlik doğrulama için aşağıdaki "API Yetkilendirmesi"ne girin.

2. Twitter Hesabı Çerezi: Yazma işlemleri için (tweet, beğeni, takip), aşağıdaki cookie alanına hedef hesabın Çerezini (örn. auth_token=...; ct0=...) girin.

🔑API Yetkilendirmesi

Anahtarı hatırlaKod örneklerine eşitle

TwexAPI Platform Anahtarı Bearer TokenZorunlu

Tüm TwexAPI uç noktalarında kullanılan genel API anahtarı. Konsoldan alınabilir.

📝İstek Gövdesiapplication/json

conversation_idstring

ZorunluConversation id from /v3/twitter/dm-history

media_hash_keystring

ZorunluAttachment media_hash_key from dm-history

key_versionstring

İsteğe bağlıOptional message key_version from dm-history (recommended).

type_namestring

İsteğe bağlıOptional IMAGE/VIDEO/GIF hint

filenamestring

İsteğe bağlıOptional filename hint

pinstring

İsteğe bağlıIdentity PIN (default 1234).

cookiestringTwitter Çerezi / Auth Token

ZorunluKullanıcının kendi yetkilendirilmiş Twitter oturum kimlik bilgileri veya auth_token (BYOC — Bring Your Own Cookie). Sıfır kimlik bilgisi saklama ile durum bilgisi olmayan proxy yürütmesi. [Kimlik Doğrulama Güvenliği](/tr/authentication#write-operations--byoc-bring-your-own-cookie) ve [Cookie Nasıl Alınır](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie) sayfasına bakın.

proxystring

İsteğe bağlıOptional HTTP proxy. Example: http://username:password@ip:port

💡 Hızlı gönder:⌘ / Ctrl+Enter

📡

暂无响应数据

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

İstek

curl -X POST "https://api.twexapi.io/v3/twitter/dm-media" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "conversation_id": "1928096185664843776:1989842918455291904",
  "media_hash_key": "blRIlZCVIO",
  "key_version": "3",
  "type_name": "VIDEO",
  "filename": "clip.mp4",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
}'

const response = await fetch("https://api.twexapi.io/v3/twitter/dm-media", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "conversation_id": "1928096185664843776:1989842918455291904",
  "media_hash_key": "blRIlZCVIO",
  "key_version": "3",
  "type_name": "VIDEO",
  "filename": "clip.mp4",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/v3/twitter/dm-media",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "conversation_id": "1928096185664843776:1989842918455291904",
  "media_hash_key": "blRIlZCVIO",
  "key_version": "3",
  "type_name": "VIDEO",
  "filename": "clip.mp4",
  "pin": "1234",
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
},
)

Yanıt

{
  "code": 200,
  "msg": "success",
  "data": {
    "url": "string",
    "path": "string",
    "content_type": "video/mp4",
    "filename": "string",
    "byte_length": 0,
    "cached": true
  }
}

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