Twitter API v1.1 メモ

memo.md

Overview: Version 1.1 of the Twitter API | Twitter Developers から

• Rate Limits は 1 window (= 15 分) 毎にリセット
  • API リソース毎に適用。ほとんどは 15 回、一部リソースは 180 回
  • REST API v1.1 Limits per window by resource | Twitter Developers
• JSON 以外は使えなくなった
• 全て要認証
  • そのうちユーザー認証なし (= アプリケーション単体) で使えるようにもなる
• API 規約更新
  • 全文: Developer Rules of the Road | Twitter Developers
  • 要約版: Rules of the Road Summary | Twitter Developers
• 表示ガイドラインが表示要件へ
  • Developer Display Requirements | Twitter Developers
• いわゆる「クライアント」が 100,000 以上のユーザートークンを持つには申請が必要
  • クライアント以外はこれとは無関係
• include_entities がデフォルトで true に

Developer Display Requirements | Twitter Developers から

• @username は必ず @ 付きで
• タイムスタンプ
  • 詳細画面: 3:00 PM - 31 May 12 の形式
  • タイムライン (24 時間以内): 20s, 3m, 5h の形式
  • タイムライン (24 時間以前): 6 Jun の形式
• 必要な場合に限り、メールで例外適用の申請が可能
• 技術的制約で従えない場合はできるだけ善処する

ツイート検索について GET search/tweets | Twitter Developers

• URL: http://search.twitter.com/search.json -> https://api.twitter.com/1.1/search/tweets.json
• RATE Limit も REST API と同じ形式 (ただし 180 回)
• page パラメータは使えない
• ツイートのデータ形式が他の REST API のものに近づいた

GET statuses/mentions | Twitter Developers

• statuses/mentions は statuses/mentions_timeline に

なくなったやつ (v1 の分類)

Timelines 系

• GET statuses/retweeted_by_me
• GET statuses/retweeted_to_me
• GET statuses/retweeted_of_me
• GET statuses/retweeted_to_user
• GET statuses/retweeted_by_user

Tweets 系

• GET statuses/:id/retweeted_by
• GET statuses/:id/retweeted_by/ids

Friends & Followers 系

• GET friendships/exists
• GET friendships/no_retweet_ids

Users 系

• GET users/profile_image/:screen_name

Lists 系

• GET lists

Accounts 系

• GET account/rate_limit_status
• GET account/totals

Notification 系

• POST notifications/follow
• POST notifications/leave

Trends 系

• GET trends/daily
• GET trends/weekly

Block 系

• GET blocks/exists

Help 系

• GET help/test

URL 変更

Timelines 系

• GET statuses/mentions -> statuses/mentions_timeline

ツイート検索

• GET search -> search/tweets (ドメイン、パスも変更)

DM 系

• GET direct_messages/show/:id -> direct_messages/show
• POST direct_messages/destroy/:id -> direct_messages/destroy

Suggested Users 系

• GET users/suggestions/:slug/members -> users/suggestions/:slug/members

Favorites 系

• GET favorites -> favorites/list

Lists 系

• GET lists/all -> lists/list

Trends 系

• GET trends/:woeid -> trends/place

Block 系

• GET blocks/blocking -> blocks/list

Legal 系

• GET legal/privacy -> help/privacy
• GET legal/tos ->help/tos