参加者の id を指定して DM メッセージを作成する

指定した参加者 ID を使用して、そのユーザーに新しいダイレクトメッセージ（DM）を送信します。

POST /2/dm_conversations/with/{participant_id}/messages

参加者の id を指定して DM メッセージを作成する

cURL

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

201

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

承認

OAuth2UserTokenUserToken

Authorization · string · header · 必須

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

パスパラメータ

participant_id · string · 必須

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

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

例:

"2244994945"

ボディ

application/json

Option 1

Option 2

text · string · 必須

メッセージの本文。

Minimum string length: 1

attachments · object[]

DM イベントに付随する情報。

Show child attributes

レスポンス

201

application/json

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

data · object

Show child attributes

errors · object[]

Minimum array length: 1

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

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Show child attributes