Skip to main content
このガイドでは、Direct Messages lookup エンドポイントをアプリケーションに統合するために必要な主要な概念を説明します。

認証

DM エンドポイントでは、プライベートな会話にアクセスするためにユーザー認証が必要です。
App-Only 認証はサポートされていません。すべてのダイレクトメッセージは非公開です。

必要なスコープ(OAuth 2.0)


会話のタイプ

1 対 1

参加者は常に 2 名のみ。会話 ID の形式: {smaller_user_id}-{larger_user_id}

グループ

2 名以上の参加者。メンバーシップは時間とともに変わることがあります。

イベントタイプ

イベント例


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 リファレンス

エンドポイントの完全なドキュメント

サンプルコード

動作するコード例