認証ユーザーへ送られたダイレクトメッセージの最新20通を取得します。送信者と受信者の詳細情報も取得されます。 一回の呼び出しで最大200のダイレクトメッセージをリクエストできます。このエンドポイントで使用できるようになるのはその200通のみです。
重要: このメソッドは RWD (読み込み、 書き込み、ダイレクトメッセージ) 権限を持つアクセストークンが必要です。 詳細情報については The Application Permission Modelを参照してください。
https://api.twitter.com/1.1/direct_messages.json
これに指定したIDよりも大きい(より新しい)IDの検索結果を取得します。このAPIでアクセスできるツイート数には制限があります。 since_idで設定した範囲がツイート数の制限に引っかかった場合、since_id は使用できる範囲で最も古いIDに置き換えられます。
サンプル値: 12345
これに指定したID以下(より古い)のIDの検索結果を取得します。
サンプル値: 54321
取得するダイレクトメッセージ数を設定します。最大値は200です。 count値が適用されると停止中のコンテンツや削除されたコンテンツが取り除かれるので、このパラメータは取得するツイートを制限するものとして考えるのがベストです。
サンプル値: 5
falseを設定すると、 entitiesノードは含まれません。
サンプル値: false
trueか t か 1 を設定した場合、取得したユーザーオブジェクトにはステータスが含まれません。
ログインして登録アプリケーションの一覧を参照してください。
GET
https://api.twitter.com/1.1/direct_messages.json?since_id=240136858829479935&count=1
[
{
"created_at": "Mon Aug 27 17:21:03 +0000 2012",
"entities": {
"hashtags": [],
"urls": [],
"user_mentions": []
},
"id": 240136858829479936,
"id_str": "240136858829479936",
"recipient": {
"contributors_enabled": false,
"created_at": "Thu Aug 23 19:45:07 +0000 2012",
"default_profile": false,
"default_profile_image": false,
"description": "Keep calm and test",
"favourites_count": 0,
"follow_request_sent": false,
"followers_count": 0,
"following": false,
"friends_count": 10,
"geo_enabled": true,
"id": 776627022,
"id_str": "776627022",
"is_translator": false,
"lang": "en",
"listed_count": 0,
"location": "San Francisco, CA",
"name": "Mick Jagger",
"notifications": false,
"profile_background_color": "000000",
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg",
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/644522235/cdjlccey99gy36j3em67.jpeg",
"profile_background_tile": true,
"profile_image_url": "http://a0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg",
"profile_image_url_https": "https://si0.twimg.com/profile_images/2550226257/y0ef5abcx5yrba8du0sk_normal.jpeg",
"profile_link_color": "000000",
"profile_sidebar_border_color": "000000",
"profile_sidebar_fill_color": "000000",
"profile_text_color": "000000",
"profile_use_background_image": false,
"protected": false,
"screen_name": "s0c1alm3dia",
"show_all_inline_media": false,
"statuses_count": 0,
"time_zone": "Pacific Time (US & Canada)",
"url": "http://cnn.com",
"utc_offset": -28800,
"verified": false
},
"recipient_id": 776627022,
"recipient_screen_name": "s0c1alm3dia",
"sender": {
"contributors_enabled": true,
"created_at": "Sat May 09 17:58:22 +0000 2009",
"default_profile": false,
"default_profile_image": false,
"description": "I taught your phone that thing you like. The Mobile Partner Engineer @Twitter. ",
"favourites_count": 584,
"follow_request_sent": false,
"followers_count": 10621,
"following": false,
"friends_count": 1181,
"geo_enabled": true,
"id": 38895958,
"id_str": "38895958",
"is_translator": false,
"lang": "en",
"listed_count": 190,
"location": "San Francisco",
"name": "Sean Cook",
"notifications": false,
"profile_background_color": "1A1B1F",
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/495742332/purty_wood.png",
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/495742332/purty_wood.png",
"profile_background_tile": true,
"profile_image_url": "http://a0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
"profile_image_url_https": "https://si0.twimg.com/profile_images/1751506047/dead_sexy_normal.JPG",
"profile_link_color": "2FC2EF",
"profile_sidebar_border_color": "181A1E",
"profile_sidebar_fill_color": "252429",
"profile_text_color": "666666",
"profile_use_background_image": true,
"protected": false,
"screen_name": "theSeanCook",
"show_all_inline_media": true,
"statuses_count": 2608,
"time_zone": "Pacific Time (US & Canada)",
"url": null,
"utc_offset": -28800,
"verified": false
},
"sender_id": 38895958,
"sender_screen_name": "theSeanCook",
"text": "booyakasha"
}
]