DM 会話を作成

curl --request POST \
  --url https://api.x.com/2/dm_conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation_type": "Group",
  "message": {
    "text": "<string>",
    "attachments": [
      {
        "media_id": "1146654567674912769"
      }
    ]
  },
  "participant_ids": [
    "2244994945"
  ]
}
'

import requests

url = "https://api.x.com/2/dm_conversations"

payload = {
    "conversation_type": "Group",
    "message": {
        "text": "<string>",
        "attachments": [{ "media_id": "1146654567674912769" }]
    },
    "participant_ids": ["2244994945"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation_type: 'Group',
    message: {text: '<string>', attachments: [{media_id: '1146654567674912769'}]},
    participant_ids: ['2244994945']
  })
};

fetch('https://api.x.com/2/dm_conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/dm_conversations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation_type' => 'Group',
    'message' => [
        'text' => '<string>',
        'attachments' => [
                [
                                'media_id' => '1146654567674912769'
                ]
        ]
    ],
    'participant_ids' => [
        '2244994945'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/dm_conversations"

	payload := strings.NewReader("{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/dm_conversations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/dm_conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "dm_conversation_id": "123123123-456456456",
    "dm_event_id": "1146654567674912769"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

POST

dm_conversations

DM 会話を作成

curl --request POST \
  --url https://api.x.com/2/dm_conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversation_type": "Group",
  "message": {
    "text": "<string>",
    "attachments": [
      {
        "media_id": "1146654567674912769"
      }
    ]
  },
  "participant_ids": [
    "2244994945"
  ]
}
'

import requests

url = "https://api.x.com/2/dm_conversations"

payload = {
    "conversation_type": "Group",
    "message": {
        "text": "<string>",
        "attachments": [{ "media_id": "1146654567674912769" }]
    },
    "participant_ids": ["2244994945"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    conversation_type: 'Group',
    message: {text: '<string>', attachments: [{media_id: '1146654567674912769'}]},
    participant_ids: ['2244994945']
  })
};

fetch('https://api.x.com/2/dm_conversations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/dm_conversations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'conversation_type' => 'Group',
    'message' => [
        'text' => '<string>',
        'attachments' => [
                [
                                'media_id' => '1146654567674912769'
                ]
        ]
    ],
    'participant_ids' => [
        '2244994945'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/dm_conversations"

	payload := strings.NewReader("{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.x.com/2/dm_conversations")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/dm_conversations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"conversation_type\": \"Group\",\n  \"message\": {\n    \"text\": \"<string>\",\n    \"attachments\": [\n      {\n        \"media_id\": \"1146654567674912769\"\n      }\n    ]\n  },\n  \"participant_ids\": [\n    \"2244994945\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "dm_conversation_id": "123123123-456456456",
    "dm_event_id": "1146654567674912769"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

承認

Authorization

string

header

必須

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

dm.write

Send and manage your Direct Messages.

tweet.read

View all Posts you can see, including those from protected accounts.

users.read

View any account you can see, including protected accounts.

ボディ

application/json

conversation_type

enum<string>

必須

作成される会話の種類。

利用可能なオプション:

Group

message

object

必須

Option 1
Option 2

Show child attributes

participant_ids

string[]

必須

DM会話の参加者。

Required array length: 2 - 49 elements

このユーザーの一意の識別子。大きな整数値を扱えない言語やツールとの互換性の問題を避けるため、文字列として返されます。

Pattern: ^[0-9]{1,19}$

レスポンス

リクエストは成功しました。

data

object

Show child attributes

errors

object[]

Minimum array length: 1

IETF RFC 7807 (https://tools.ietf.org/html/rfc7807) で定義された HTTP Problem Details オブジェクト。

Show child attributes

概要

投稿

ユーザー

ダイレクトメッセージ

いいね

リスト

スペース

コミュニティ

コミュニティノート

トレンド

ニュース

メディア

X のアクティビティ

利用状況

ストリーム接続

コンプライアンス

Enterprise v2

いいねのストリーム

GNIP 2.0

DM 会話を作成

承認

Scopes

ボディ

レスポンス