ストリーミングAPI

ストリーミングAPIを使うと、リアルタイムで様々な情報(例えばタイムラインに新しい投稿が流れてきた、メッセージが届いた、フォローされた、など)を受け取ったり、HTTPリクエストを発生させることなくAPIにアクセスしたりすることができます。

ストリームに接続する

以下のURLにwebsocket接続します。

%URL%

接続する際は、iというパラメータ名で認証情報を含めます。例:

%URL%/?i=xxxxxxxxxxxxxxx

ストリームを経由してAPIリクエストすると、HTTPリクエストを発生させずにAPIを利用できます。そのため、コードを簡潔にできたり、パフォーマンスの向上を見込めるかもしれません。

ストリームを経由してAPIリクエストするには、次のようなメッセージをストリームに送信します:

{
	type: 'api',
	id: 'xxxxxxxxxxxxxxxx',
	endpoint: 'notes/create',
	data: {
		text: 'yee haw!'
	}
}

idには、APIのレスポンスを識別するための、APIリクエストごとの一意なIDを設定する必要があります。UUIDや、簡単な乱数のようなもので構いません。

endpointには、あなたがリクエストしたいAPIのエンドポイントを指定します。

dataには、エンドポイントのパラメータを含めます。

APIのエンドポイントやパラメータについてはAPIリファレンスをご確認ください。

APIへリクエストすると、レスポンスがストリームから次のような形式で流れてきます。

{
	type: 'api-res:xxxxxxxxxxxxxxxx',
	body: {
		...
	}
}

xxxxxxxxxxxxxxxxの部分には、リクエストの際に設定されたidが含まれています。これにより、どのリクエストに対するレスポンスなのか判別することができます。

bodyには、レスポンスが含まれています。