1. Twitter API 1.1
#twtr_hack
2013/2/1
Yusuke Yamamoto

2. 2012年8月16日のアナウンス
https://dev.twitter.com/blog/changes-coming-to-twitter-api
Yusuke Yamamoto

3. http://www.atmarkit.co.jp/ait/articles/1209/26/news120.html
Yusuke Yamamoto

4. 概要
• Twitter エコシステムの定義
• デベロッパ利用規約の変更
• API1.0からAPI 1.1へ
Yusuke Yamamoto

5. Twitter エコシステム
Yusuke Yamamoto

6. Twitter エコシステム
https://dev.twitter.com/blog/changes-coming-to-twitter-api より
Yusuke Yamamoto

7. Twitter エコシステム
CRM
クライアント
エンタープライズ
シンジケーション
メディア連携
分析 影響力ランキング
https://dev.twitter.com/blog/changes-coming-to-twitter-api より
Yusuke Yamamoto

8. セグメントの例
https://dev.twitter.com/blog/changes-coming-to-twitter-api より
Yusuke Yamamoto

9. TwitterがAPIを使ってやってもらいたいこと
upper-left
lower-left lower right
“we're trying to encourage activity in the upper-left, lower-left and lower
right quadrants, and limit certain use cases that occupy the upper-right
quadrant.”
https://dev.twitter.com/blog/changes-coming-to-twitter-api より
Yusuke Yamamoto

10. 何が良くて何が良くないのか
• 定量的な判断基準はない
• クライアントアプリビジネスは今後かなり無理
• キーポイント
• Twitterのビジネスにとって有益になりそうかどうか
• 利用規約の原則
‣ Don't surprise users
‣ Don't create or distribute spam
‣ Respect user privacy
‣ Be a good partner to Twitter
Yusuke Yamamoto

11. デベロッパ利用規約
Yusuke Yamamoto

12. デベロッパ利用規約
• Display GuidelineからRequirementsへ
• Guideline: 「なるべく守って欲しいな」
• Requirements: 「守れ」
Yusuke Yamamoto

13. Display Guidelines
https://dev.twitter.com/terms/display-guidelinesより
Yusuke Yamamoto

14. Display Requirements
https://dev.twitter.com/terms/display-requirementsより
Yusuke Yamamoto

15. ツイートのレンダリング
• @ユーザー名の頭には@を付ける: @yusuke
• 必ずavatar(アイコン)を表示:
• 名前は@ユーザー名より先(左か上)に表示
• @ユーザー名、名前はアイコンの右側、または
左側に表示
• アイコン、名前、@ユーザー名はTwitterのプロ
フィールにリンク
Yusuke Yamamoto

16. タイムラインのレンダリング
• ユーザーにはTwitterのタイムラインを見せてい
ることを明確にする
• タイムラインに隣接(上部など)する形でTwitter
のロゴを配置
https://twitter.com/logo より
Yusuke Yamamoto

17. 利用規約その他
http://www.slideshare.net/yusukey/twitter-api-5
Yusuke Yamamoto

18. API 1.0からAPI1.1
Yusuke Yamamoto

19. API 1.0からAPI1.1へ
• エンドポイントの変更
• レートリミット方式変更
• OAuth必須化
Yusuke Yamamoto

20. エンドポイントの変更
• バージョン1.1に
http://api.twitter.com/1/users/show.json?screen_name=yusuke
http://api.twitter.com/1.1/users/show.json?screen_name=yusuke
• xmlは廃止、json のみに
Yusuke Yamamoto

21. 廃止されるエンドポイント
public_timeline.json
account_totals.json
retweeted_by_ids.json
retweeted_by_me.json
retweeted_by_user.json
retweeted_to_me.json
retweeted_to_user.json
daily_trends.json
weekly_trends.json
retweeted_by.json
blocks/exists.json
friendship/exists.json
test.json
Yusuke Yamamoto

22. 廃止エンドポイントを呼ぶと？
４０４
Yusuke Yamamoto

23. レートリミット方式変更
• API 1.0
• 1カウント 350回/1時間
• API 1.1
• 基本: 1エンドポイント 15回/15分
• 多く使われるエンドポイント: 180回/15分
statuses/user_timeline.json
statuses/show/:id.json
search/tweets.json
users/lookup.json
users/show.json
users/search.json
application/rate_limit_status.json
Yusuke Yamamoto

24. OAuth必須化
• API 1.0
• 一部APIは 150回/1時間 でOAuthなしで呼び出し可
• API 1.1
• 全エンドポイントOAuthが必須
Yusuke Yamamoto

25. 期限
• API 1.0は3月5日に廃止
• @Anywhere、ウィジェットも3月5日に廃止
https://dev.twitter.com/docs/anywhere/welcome
Yusuke Yamamoto

26. 移行方法
• Java
• Twitter4Jを3.0.xに切り替え
• コンパイルエラーの出る箇所を潰す
• 移行ガイドを参照
http://twitter4j.org/ja/versions.html#migration22x-30x
• 他の言語
• 置換: s/api.twitter.com/1/(.*)$/api.twitter.com/1.1/$1/g
• テスト→404で失敗する場所を潰す
Yusuke Yamamoto