認証
DM エンドポイントでは、プライベートな会話にアクセスするためにユーザー認証が必要です。必要なスコープ(OAuth 2.0)
会話のタイプ
1 対 1
参加者は常に 2 名のみ。会話 ID の形式:
{smaller_user_id}-{larger_user_id}グループ
2 名以上の参加者。メンバーシップは時間とともに変わることがあります。
イベントタイプ
イベント例
MessageCreate
MessageCreate
ParticipantsJoin
ParticipantsJoin
ParticipantsLeave
ParticipantsLeave
Fields と expansions
デフォルトフィールド
利用可能なフィールド
利用可能な expansions
expansions を使用した例
cURL
ページネーション
DM イベントは新しい順(新しいものが先)に返されます。cURL
最大 過去 30 日 までのイベントを取得できます。
v1.1 との ID 互換性
会話 ID とイベント ID は v1.1 と v2 のエンドポイント間で共有されています。つまり、次のことが可能です。- v2 でイベントを取得し、v1.1 で特定のメッセージを削除する
- x.com URL の会話 ID を API リクエストで参照する
次のステップ
クイックスタート
最初の DM lookup リクエストを実行
DM を送信
ダイレクトメッセージを送信
API リファレンス
エンドポイントの完全なドキュメント
サンプルコード
動作するコード例