大分類2種類
REST APIs
Streaming APIs
┏REST APIs
┃┣The Search API
┃┗Media API
┃
┗Streaming APIs
Streaming APIs
中分類4種類
┏REST APIs
┃┣The Search API
┃┗Media API
┃
┗Streaming APIs
REST APIs ／ Streaming APIs
REST APIs
ツイートの更新や参照を行う最も基本的な API
・HTTP経由で URL 「api.twitter.com」へにクエリーを渡し(リクエストを送信し)てレスポンスを得る REST を利用
REST
・REpresentational State Transfer
・パラメータを指定して特定のURLにHTTPでアクセスすると、JSONで記述されたメッセージが送られてくるようなシステムおよび呼び出しインターフェース(「RESTful API」と呼ばれる)のことを指す
・システムの状態やセッションに依存せず、同じURLやパラメータの組み合わせからは常に同じ結果が返されることが期待される
URL
・api.twitter.com
型
・pull型なので、クライアントが能動的にリクエストを発行しなければ情報を受け取ることが出来ない
処理の流れ
・1.クライアントからTwitterサーバへHTTP接続を開く
・2.クライアントがリクエストを送出
・3.サーバがレスポンスを送り返す
・4.接続を閉じる
Streaming APIs
パブリック・タイムラインや特定の検索語彙、ユーザーID、位置情報によるフィルタリングで流れてくるリアルタイムな情報を取得するためのAPI
URL
・stream.twitter.com
型
・push型なので、リアルタイムに情報を受け取ることが可能
処理の流れ
・1.クライアントからTwitterサーバへHTTP接続を開く
・2.クライアントがリクエストを送出
・3.サーバ は次々にレスポンスを送り返す
・4.エラー等で切断されるまでずっと接続を維持し続ける
小分類 ／ 機能別 ／ REST APIs
statuses ／ ツイート
GETメソッド
・取得
| - | URL | 内容 | 備考 |
|---|---|---|---|
| 1 | statuses/user_timeline | userツイート取得 | 指定したユーザーのタイムラインを取得（つぶやき非公開ユーザーの場合は要認証） |
| 2 | statuses/home_timeline | ホーム画面のタイムライン取得 | 認証ユーザーとその友達のリツイートを含む最新のつぶやきを取得（要認証） |
| - | statuses/oembed | ツイートIDを指定して、埋め込み用HTMLを取得 | - |
・投稿
| - | URL | 内容 | |
|---|---|---|---|
| 1 | statuses/update | ツイート投稿。画像、動画を添付しての投稿も可能 | - |
media ／ メディアアップロード
POSTメソッド
・投稿
| - | URL | 内容 |
|---|---|---|
| 1 | media/upload | 画像投稿 |
| 2 | media/upload(chunked) | 動画投稿 |
search ／ 検索API
ツイートを検索する API
・REST を使うが、 特定のアカウントに関する操作ではないためログイン認証は不要
GETメソッド
・取得
| - | URL | 内容 | 備考 |
|---|---|---|---|
| 1 | search/tweets | ツイート検索 | 取得できるツイート数の上限は 100件。デフォルト15件 |
trends ／ トレンド情報
GETメソッド
・取得
| URL | 内容 |
|---|---|
| trends/place | トレンド取得 |
| trends/available | トレンドの地域一覧を取得 |
| trends/closest | 位置座標のWOEIDを取得 |
account ／ アカウント
GETメソッド
・取得
| - | URL | 内容 | 備考 |
|---|---|---|---|
| 1 | account/verify_credentials | アカウントの有効性を確認 | アカウントが有効か否かを確認 |