İçeriğe geç
Twexapi
Türkçe
Esc
gezin⌘Jönizle

DM Gönder (XChat v3)

DM Gönder (XChat v3).

POST/v3/twitter/send-dm
API Yetkilendirmesi
AuthorizationBearer token · headerzorunlu
TwexAPI genel Bearer Token kimlik bilgisi. İstek başlığı: Authorization: Bearer <YOUR_TWEXAPI_KEY>.
İstek Gövdesi
zorunluapplication/json
recipientstringzorunlu
User id, @handle, or a group id (g...) for an existing group.
textstringzorunlu
Mesaj metni
media_urlsstring[] | any
Eklenecek görsel veya video URL listesi (maksimum 4 resim veya 1 video)
Özellikleri göster
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).
Ö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
200A message object.
codeintegerzorunlu
HTTP durum kodu (200 başarılı anlamına gelir)
msgstringzorunlu
Yanıt mesajı (örn: 'success')
dataMessageModel | anyzorunlu
Uç nokta tarafından döndürülen ana veri
Özellikleri göster
Any of:
MessageModel
idstringzorunlu
Message ID
textstringzorunlu
Mesaj metni
timestringzorunlu
Message time
attachmentobject | any
Message attachment
Özellikleri göster
Any of:
object
object
any
any
attachmentsobject[] | any
XChat media attachments (v3).
Özellikleri göster
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.
Özellikleri göster
Any of:
string
string
any
any
sender_idstring | any
Sender ID
Özellikleri göster
Any of:
string
string
any
any
recipient_idstring | any
DM alıcısının Twitter ID'si
Özellikleri göster
Any of:
string
string
any
any
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 KonsolPOST
Etkileşimli Konsol / API TestiPOST
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
📝İstek Gövdesiapplication/json
📡
暂无响应数据

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

İstek
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"
}'
Yanıt
{
  "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"
  }
}