Things Every Developer Should Know |
安全のために 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を参照してください。
Tweet IDs are enormous and break JavascriptUse the |
APIを使い始める場合は、API FAQの内容をよく理解し、FAQがあるということを覚えておいてください。
The contents of the FAQIf you are starting with the API, please familiarize yourself with the API FAQ and know that it exists. |
現在公開されている Twitter API は、大きく分けて REST API と ストリーミングAPIの二つがあります。 ほとんどのアプリケーション開発者はこのAPIを組み合わせ、最適な物を使ってアプリケーションを作成します。 API 概要 の「入門」の部分でその成り立ちを説明しています。 ストリーミング API を使うと、ツイートに対して遅延の少ない高容量のアクセスが行えます。
There are many APIsThe public Twitter API currently consists of two discrete REST APIs and a Streaming API. Most application developers mix and match the APIs to produce their application. The API Overview portion of the Getting Started series explains the history. The Streaming API provides low-latency high-volume access to Tweets. |
ユーザーの濫用からTwitter を守るために、APIの使用は速度制限および公正使用制限が課せられています。
There are limits to how many calls and changes you can make in a dayAPI usage is rate limited with additional fair use limits to protect Twitter from abuse. |
Twitter APIからデータを取得するメソッドでは GET
リクエストが必要です。データを送信したり変更したり破棄したりするメソッドではPOST
が必要です。
データを破棄する場合は DELETE
リクエストも使用できます。特定のHTTPメソッドが必要なAPIメソッドでは、正しい設定でリクエストを作成しなかった場合はエラーが返ります。 HTTP レスポンスコード を読むと役立つでしょう。
The API is entirely HTTP-based (over SSL)Methods to retrieve data from the Twitter API require a |
ストリーミング APIを除き、 Twitter API は Representational State Transfer (REST)の設計原則に準拠しています。 Twitter APIs は JSON データ形式を使用しています。
The API is a RESTful resourceWith the exception of the Streaming API, the Twitter API attempts to conform to the design principles of Representational State Transfer (REST). Twitter APIs use the JSON data format. |
一部のAPI メソッドでは、任意もしくは必須のパラメータがあります。パラメータを付けてリクエストを作成する場合は以下を忘れないでください:
page
パラメータは0ではなく1から始まります。
注意書きがある場合、いくつかの API メソッドではクライアントが送信したHTTPヘッダの値に基づかない結果を返します。 同じ動作をパラメータとHTTPヘッダの両方で制御できる場合は、パラメータに設定した値が優先されます。
Parameters have certain expectationsSome API methods take optional or requisite parameters. Keep in mind when making requests with parameters:
Where noted, some API methods will return different results based on HTTP headers sent by the client. Where the same behavior can be controlled by both a parameter and an HTTP header, the parameter will take precedence. |
クライアントは、user_timeline REST APIメソッドの page
パラメータとcount
パラメータを使って、理論上では最大3200個のツイートにアクセスすることができます。ほかのタイムラインでは、理論王では最大800個のツイートを持ちます。その制限を越えてリクエストをすると、リクエストされた形式でステータスコード200と空の応答結果が返ります。 Twitter はユーザーによって送信された全てのツイートをデータベースに保持しています。しかし、サイトのパフォーマンスを維持するために、 this artificial limit is temporarily in place.
There are pagination limitsRest API LimitClients may access a theoretical maximum of 3,200 statuses via the |
コミュニティでは多くの Twitter API ライブラリを作成しました。私たちの知らないライブラリがあれば、是非教えてください。
There are Twitter API libraries for almost any languageThe community has created numerous Twitter API libraries. If you know of others we haven’t got let us know. |