内容

待望のTwitter APIリファレンス、登場！！

Twitterが人気を集めている理由の1つにAPIが公開されていることが上げられます。クライアントツールだけではなく、たくさんのユーザーによるつぶやき（ツイート）をさまざまな角度から集め、加工して新しいサービスに展開する―Twitterが生み出すサービスは二次的、三次的にも広がっています。また、Twitter APIを利用することで、誰にでも可能なのです。

OAuthの導入、リストの登場、リツイートに位置情報、そして、ストリーミングAPIの登場―Twitter APIの種類は多岐に渡り、「できること」の幅は広がっています。本書は、Twitter API公式ドキュメントをもとに、それぞれのAPIの使い方をわかりやすく解説しています。合わせてサンプルコードも紹介していますので、アイデアをすぐに形にすることができます。

Twitter APIの最新事情をまとめた必携の1冊です！

目次

1 Twitter APIを使う前の基礎知識

1.1 Twitter API の概要

• タイムライン（timeline）
  • Twitter で使われる用語
• Twitter APIの体系
• REST
  • 特別な引数
  • HTTPステータスコード（レスポンス）
  • APIの実行回数制限
• ストリーミングAPI
  • ストリーミングAPIの使い方

1.2 BASIC認証

• BASIC認証の手順

1.3 OAuth

• OAuthの手順
• OAuthの署名生成
  • HMAC-SHA1による署名の生成
• リクエストトークン取得の手順
• アクセストークンの取得
• APIの実行

1.4 xAuth

• xAuthの手順
• xAuthでのアクセストークンの取得

2 Twitter APIを使ったサンプルプログラム

2.1 各APIの使い方

• タイムラインの取得
• ツイートの投稿
• フォローしている/されている
• お気に入りの登録、リツイートの投稿
• API実行制限の状況を取得する
• Twitterアカウントを自サイトの認証に利用する
• 簡易クライアント
• ストリーミングAPIを使ったツイートの取得

2.2 OAuth、xAuth関連

• iPhone用（Objective-c）の実装例
• .NET Framework向けの実装例
• PHPの実装例
• Pythonの実装例
• Rubyの実装例
• Perlの実装例
• 自分でOAuth、xAuthを実装するためのヒント
  • HMAC-SHA1の実装
  • リクエストトークンの取得
  • アクセストークンの取得
  • APIの実行

Column

• xAuthによるアクセストークンの取得をプロキシサーバ越しに行う場合の注意点

3 Twitter APIリファレンス

REST API

• 1. タイムライン関連のAPI
  • statuses/public_timeline
  • statuses/home_timeline
  • statuses/friends_timeline
  • statuses/user_timeline
  • statuses/mentions
  • statuses/retweeted_by_me
  • statuses/retweeted_to_me
  • statuses/retweets_of_me
• 2. ツイート関連のAPI
  • statuses/show
  • statuses/update
  • statuses/destroy
  • statuses/retweet
  • statuses/retweets
• 3. ユーザー情報関連のAPI
  • users/show
  • users/lookup
  • users/search
  • users/suggestions
  • users/suggestions/slug
  • statuses/friends
  • statuses/followers
• 4. リスト関連のAPI
  • POST lists
  • POST list id
  • GET lists
  • GET list id
  • DELETE list id
  • GET list statuses
  • GET list memberships
  • GET list subscriptions
  • GET list members
  • POST list members
  • DELETE list members
  • GET list members id
  • GET list subscribers
  • POST list subscribers
  • DELETE list subscribers
  • GET list subscribers id
• 5. ダイレクトメッセージ関連のAPI
  • direct_messages
  • direct_messages/sent
  • direct_messages/new
  • direct_messages/destroy
• 6. フォロー関係に関するAPI
  • friendships/create
  • friendships/destroy
  • friendships/exists
  • friendships/show
• 7. ソーシャルグラフ関連のAPI
  • friends/ids
  • followers/ids
• 8. アカウント関連のAPI
  • account/verify_credentials
  • account/end_session
  • account/rate_limit_status
  • account/update_delivery_device
  • account/update_profile_colors
  • account/update_profile_image
  • account/update_profile_background_image
  • account/update_profile
• 9. お気に入り関連のAPI
  • favorites
  • favorites/create
  • favorites/destroy
• 10. 通知関連のAPI
  • notifications/follow
  • notifications/leave
• 11. ブロック関連のAPI
  • blocks/create
  • blocks/destroy
  • blocks/exists
  • blocks/blocking
  • blocks/blocking/ids
• 12. スパム報告API
  • report_spam
• 13. 補助API
  • help/test
• 14. OAuth関連のAPI
  • oauth/request_token
  • oauth/authorize
  • oauth/authenticate
  • oauth/access_token
  • oauth/access_token［xAuth］
• 15. 保存済み検索条件関連のAPI
  • saved_searches
  • saved_searches/show
  • saved_searches/create
  • saved_searches/destroy
• 16. 地域情報関連のAPI
  • trends/available
  • trends/location
• 17. 位置情報関連のAPI
  • geo/reverse_geocode
  • geo/nearby_places
  • geo/id
• REST API の応答に含まれる各種情報
  • ユーザー情報
  • ステータス情報
  • リツイートされたステータスの情報
  • タイムライン情報
  • ダイレクトメッセージ情報
  • リスト情報
  • カーソル位置情報つきユーザー一覧情報
  • カーソル位置情報つきユーザーID一覧情報
• Column
  • アプリケーションの登録

検索関連のAPI

• 1. 検索関連のAPI
  • search
  • trends
  • trends/current
  • trends/daily
  • trends/weekly
• Twitterの検索で使用可能な演算子と応答情報

ストリーミングAPI

• 1. public_timelineを取得するストリーミングAPI
  • statuses/firehose
  • statuses/gardenhose
  • statuses/sample
• 2. 一定の条件を満たすツイートを取得するストリーミングAPI
  • statuses/filter
  • statuses/links
  • statuses/retweet
• Column
  • ストリーミングAPIに用意されたバージョン
• ストリーミングAPIから送られてくるストリーム

Appendix

Appendix I

• Buzztter
• TweetBubbles&ツイ坊
• モバツイ
• 秋月パルス＆秋月ドランク

Appendix II

• 自動読み上げラジオbot「Voice of Twitter」

立ち読み

お詫びと訂正

●P.25　1行目
【誤】❷ 「文字列その2」をBase64エンコードする
【正】❷ 「文字列その2」をパーセントエンコードする^*11

●P.26　下から5行目
【誤】❷ 「文字列その2」をBase64エンコードする
【正】❷ 「文字列その2」をパーセントエンコードする^*13

●P.29　下から8行目
【誤】❸ ❷で得た結果をBase64エンコードする
【正】❸ ❷で得た結果をパーセントエンコードする^*14

●P.33　下から6行目
【誤】❷ 「文字列その2」をBase64エンコードする
【正】❷ 「文字列その2」をパーセントエンコードする^*15


●P.83
83ページで紹介している
　・OAuth library for Twitter and Jaiku (Twitter's xAuth ready)
　http://gist.github.com/333447
に誤りが見つかりました。具体的にはOAuthTwitter.csの66行目、OAuthJaiku.csの63行目が間違っていました。現在、上記URLに置いてあるコードは修正済みです。
このコードはサンプルコードとして配布しているコード7（code7.zip）にも含まれておりますので、誠にお手数ですが再度ダウンロード願います。