Twitter API 仕様書 (勝手に日本語訳シリーズ)

☆

最終更新: 2008年4月30日

Twitter の API 仕様書を和訳してみました。そのまま訳したというのとはちょっと違って、実際に使ってみて気付いたことを反映して書き直してたりします。まだ、手直ししたいところもあるけど、とりあえず公開。

• Twitter API 仕様書 第十二版 (2008年4月25日版) (最新版)
• Twitter API 仕様書 (日本語) [2008年1月22日版]
• Twitter API 仕様書 (日本語) [2007年11月20日版]
• Twitter API 仕様書 (日本語) [2007年10月19日版]
• Twitter API 仕様書 (日本語) [2007年8月30日版]
• Twitter API 仕様書 (日本語) [2007年7月27日版]
• Twitter API 仕様書 (日本語) [2007年7月17日版]
• Twitter API 仕様書 (日本語) [2007年7月10日版]
• Twitter API 仕様書 (日本語) [2007年6月13日版]
• Twitter API 仕様書 (日本語) [2007年6月4日版]
• Twitter API 仕様書 (日本語) [2007年5月24日版]
• Twitter API 仕様書 (日本語) [2007年4月28日版] (最初の版)

今後も API の変更、追加は頻繁に行なわれると思いますので、上記、日本語訳も適宜、更新していきたいと思います。
[2007年9月1日、追記: 第1版の URI を http://watcher.moe-nifty.com/memo/docs/twitterAPI1.txt に変更し、最新版に関して、版数が変わっても常に同じ URI でアクセスできるようにしました。→ Twitter API 仕様書 (日本語) [最新版]]

Twitter Fan Wiki / API Docs の方も訳して、適宜、注釈をつけたのを用意しようと思ってます。(→ と思ってたんですが、あそこに書いてあることは、全部が全部実装されている訳ではなくて、こういう実装になったらいいな、という Twitter ファンの要望も混じっているみたいです。どこまでが要望なのか、よくわからないこともあって、混乱を避けるため、訳すのは見送っています)

変更履歴

• 2008年 4月25日 第十二版 (2008年4月25日版原本がベース)
  1. 「ユーザ情報関連のAPI」の friends に“page 引数”と“lite 引数”を追加
  2. 「ユーザ情報関連のAPI」の followers に“page 引数”を追加
  3. 「備考」に“in_reply_to”を追加
• 2008年 3月 3日 第十一版 (2008年1月22日版原本がベース)
  1. 「IM関連のAPI」を追加
• 2007年11月27日 第十版 (2007年11月20日版原本がベース)
  1. 「HTTPステータスコード(レスポンス)」の説明を追加
  2. 「ステータス関連のAPI」の friends_timeline と user_timeline の“page 引数”に「但し書き」を各々追加
  3. 「ユーザ情報関連のAPI」の followers の“id 引数”に関する「但し書き」を追加
  4. 「ユーザ情報関連のAPI」の show に“email 引数”を追加
  5. 「ダイレクトメッセージ関連のAPI」の new の format から rss, atom を削除
  6. 「アカウント関連のAPI」に archive を追加
  7. 「フレンド関連のAPI」の favorites の説明を修正 (仕様書と実装が一致しなくなった)
  8. 「フレンド関連のAPI」の create と destroy の「注意書き」を削除 (仕様書と実装が一致するようになった)
• 2007年11月9日 第九版 (2007年10月19日版原本がベース)
  1. 「お気に入り関連のAPI」の create と destroy の説明を現実の実装に合わせて修正
• 2007年8月31日 第八版 (2007年8月30日版原本がベース)
  1. 「API の実行回数制限」の説明を更新。ステータスコード 400 に関する記述を追加
  2. 「ステータス関連のAPI」の user_timeline に “page 引数”を追加
  3. 「ユーザ情報関連のAPI」の featured の JSON形式の特殊仕様に関する説明を削除 (callback引数指定時の特殊仕様が廃止された)
  4. 「ユーザ情報関連のAPI」の followers に“lite 引数”を追加
  5. 「お気に入り関連のAPI」(favorites, create, destroy) を追加
  6. 「フレンド関連のAPI」の create と destroy の説明を修正
• 2007年8月16日 第七版 (2007年7月27日版原本がベース)
  1. 「ステータス関連のAPI」の destroy の説明を修正
  2. 「ユーザ情報関連のAPI」の friends の説明を修正 (原本自体にも間違いがある → 報告済み)
  3. 「ユーザ情報関連のAPI」の followers の説明を修正
  4. 「アカウント関連のAPI」の verify_credentials を修正 (実際に使ってみた結果を反映)
  5. 「アカウント関連のAPI」の end_session を修正 (実際に使ってみた結果を反映)
  6. 「認証」を追加
  7. 「REST」を追加
  8. 「変更を検討中のもの」を追加 (2007年7月27日版原本で追加された)
• 2007年7月19日 第六版 (2007年7月17日版原本がベース)
  1. 「アカウント関連のAPI」の verify_credentials の仕様を変更
  2. 「備考」のタイムスタンプのパターン例を追加
• 2007年7月17日 第五版 (2007年7月10日版原本がベース)
  1. 「API の実行回数制限」の項を追加
  2. 「ステータス関連のAPI」の friends_timeline に “page 引数”を追加
  3. 「ステータス関連のAPI」の update に “source 引数”を追加
  4. 「ステータス関連のAPI」の replies に “page 引数”を追加
  5. 「ユーザ情報関連のAPI」の friends に最大取得可能件数に関する説明を追加
  6. 「ユーザ情報関連のAPI」の featured の JSON形式に関する特殊仕様に関する説明を追加
  7. 「ダイレクトメッセージ関連のAPI」の direct_messages の最大取得可能件数に関する説明、“since_id 引数”、“page 引数”を各々追加
  8. 「ダイレクトメッセージ関連のAPI」の sent を追加
  9. 「アカウント関連のAPI」(verify_credentials と end_session) を追加
• 2007年6月13日 第四版 (2007年6月13日版原本がベース)
  1. 「ステータス関連のAPI」に destroy を追加
  2. 「ダイレクトメッセージ関連のAPI」に destroy を追加
  3. 「備考」に JSONP に関する記述を追加
• 2007年6月 4日 第三版 (2007年5月30日版原本がベース)
  1. 「ステータス関連のAPI」に replies を追加
  2. 「フレンド関連のAPI」(create と destroy) を追加
  3. 「ユーザ情報関連のAPI」の featured に注記を追加
• 2007年5月24日 第二版 (2007年5月11日版原本がベース)
  1. (1) 「ステータス関連のAPI」の show に関する記述を修正
  2. (2) 「ステータス関連のAPI」の update に注記を追加
  3. (3) 「備考」を追加
• 2007年4月25日 最初の勝手訳 (2007年4月22日版原本がベース)
  1. (実際に公開したのは2007年4月28日)

参考

拙著「Twitter!―Twitter APIガイドブック」では、 (2007年9月18日時点での) Twitter の API 仕様について、より詳細な解説を行なっています。 API の利用例(C/C++、perl、Ruby、python、JavaScript によるサンプルプログラムや、API を実際に利用しているWebサイトの紹介、など)も載せていますので、参考にしてください。

Twitter!―Twitter APIガイドブック

関連記事

• Twitter の本を書きました ― 「Twitter! ― Twitter APIガイドブック」
• Twitter の Web ページで from Chirrup という表示が出るようになりました
• Twitter の API の実行回数制限が導入されたようです
• Twitter の API に関するメモ
• Twitterクライアント chirrup