サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳

全ての開発者が知っておくべきこと



ツイートIDは非常に大きな値になるので、Javascriptでエラーが発生します

安全のために idフィールドではなくid_strフィールドを使用してください。Your web browser/Javascript interpreter/JSON consumer may munge our large integer-based ids which is why it’s recommended to use the string representation. Twitter IDs, JSON and Snowflakeを参照してください。



FAQの内容

APIを使い始める場合は、API FAQの内容をよく理解し、FAQがあるということを覚えておいてください。



たくさんのAPIがあります

現在公開されている Twitter API は、大きく分けて REST API と ストリーミングAPIの二つがあります。 ほとんどのアプリケーション開発者はこのAPIを組み合わせ、最適な物を使ってアプリケーションを作成します。 API 概要 の「入門」の部分でその成り立ちを説明しています。 ストリーミング API を使うと、ツイートに対して遅延の少ない高容量のアクセスが行えます。



API呼び出しやTwitter上で行える操作には、一日当たりの制限が課せられています。

ユーザーの濫用からTwitter を守るために、APIの使用は速度制限および公正使用制限が課せられています。



API は全てHTTPベース(SSL経由)です

Twitter APIからデータを取得するメソッドでは GET リクエストが必要です。データを送信したり変更したり破棄したりするメソッドではPOSTが必要です。 データを破棄する場合は DELETE リクエストも使用できます。特定のHTTPメソッドが必要なAPIメソッドでは、正しい設定でリクエストを作成しなかった場合はエラーが返ります。 HTTP レスポンスコード を読むと役立つでしょう。



API は RESTful なリソースです

ストリーミング APIを除き、 Twitter API は Representational State Transfer (REST)の設計原則に準拠しています。 Twitter APIs は JSON データ形式を使用しています。



Parameters have certain expectations

一部のAPI メソッドでは、任意もしくは必須のパラメータがあります。パラメータを付けてリクエストを作成する場合は以下を忘れないでください:

  • パラメータの値は UTF-8 と URL encodedに変換してください。
  • page パラメータは0ではなく1から始まります。

注意書きがある場合、いくつかの API メソッドではクライアントが送信したHTTPヘッダの値に基づかない結果を返します。 同じ動作をパラメータとHTTPヘッダの両方で制御できる場合は、パラメータに設定した値が優先されます。



ページ制御の制限があります

Rest API 制限

クライアントは、user_timeline REST APIメソッドの pageパラメータとcountパラメータを使って、理論上では最大3200個のツイートにアクセスすることができます。ほかのタイムラインでは、理論王では最大800個のツイートを持ちます。その制限を越えてリクエストをすると、リクエストされた形式でステータスコード200と空の応答結果が返ります。 Twitter はユーザーによって送信された全てのツイートをデータベースに保持しています。しかし、サイトのパフォーマンスを維持するために、 this artificial limit is temporarily in place.



ほぼ全てのプログラム言語で Twitter API ライブラリが用意されています

コミュニティでは多くの Twitter API ライブラリを作成しました。私たちの知らないライブラリがあれば、是非教えてください。