旧 Twitter API 分類 ／ 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.エラー等で切断されるまでずっと接続を維持し続ける

statuses ／ ツイート

GETメソッド
・取得

-	URL	内容	備考
1	statuses/user_timeline	userツイート取得	指定したユーザーのタイムラインを取得（つぶやき非公開ユーザーの場合は要認証）
2	statuses/home_timeline	ホーム画面のタイムライン取得	認証ユーザーとその友達のリツイートを含む最新のつぶやきを取得（要認証）
-	statuses/oembed	ツイートIDを指定して、埋め込み用HTMLを取得	-

POSTメソッド
・投稿

-	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	アカウントの有効性を確認	アカウントが有効か否かを確認