Twitter API
Web上でのホーム(母屋)はここなので、離れに行けるようにしようと思って、サイドバーにtwitter上での最近のつぶやきを追加してみました。というのは建前で、どのようにAPIが設計されているか調べたいと思って遊んでみました。
Twitter APIの確認
主なルールは、Twitter API 仕様書より以下のとおり。可能な限り REST に準拠しようとしているそうです。
認証
public_timeline の取得等一部の API を除くほとんどの API で、認証を使用する。応答に protected なユーザに関する情報が含まれる可能性のある API は認証が必須となっている。
引数
API によっては、必須の引数があったり、オプションとして指定可能な引数があったりする。文字列を引数にとる API を使う場合、その文字列を UTF-8 に変換し、URLエンコードする必要がある。
HTTPリクエスト
特に注釈がない場合、Twitter の API は GET を使う。「発言」の投稿と、ダイレクトメッセージの送信のみ、POST を使う。destroy 系のAPIに関しては、DELETE も使える。
HTTPステータスコード(レスポンス)
存在しない API を実行しようとしたり、存在しないユーザを引数で指定して API を実行しようとすると、404 Not Found が返る。認証に失敗した場合は、401 Not Authorized が返る。
API の実行回数制限
Twitter の API は、60分間に150回まで実行できる。この実行回数制限を超えた状態でさらにリクエストを送った場合、HTTPステータスコード 400 が返る。
サイドバーのデザイン変更
設定の仕方は簡単。管理ツールトップ > 詳細デザイン設定で、ページのフッタのテキストエリアに以下を貼り付けるだけ。
<div class="hatena-module"> <div class="hatena-moduletitle"><a href="http://twitter.com/ee83126">最近のつぶやき</a></div> <div class="hatena-modulebody"> <hatena name="rss" url="http://twitter.com/statuses/user_timeline/ee83126.rss" listlimit="5"> </div> </div>