HTTP/HTTPSでデバイスからプラットフォームへストリームを送信する

HTTP/HTTPS Endpoint

URI	HTTPメソッド	API version

URI	HTTPメソッド	API version
http://m.thingscale.io/post_v1/ (Secure)https://m.thingscale.io/post_v1/	POST	1.x
http://m.thingscale.io/post_v2/ (Secure)https://m.thingscale.io/post_v2/	POST	2.x

パラメータ

リクエストパラメータ	説明

リクエストパラメータ

説明

Header:

(API v1.x)Content-Type:application/x-www-form-urlencoded

(API v2.x)Content-Type:application/json

X-DEVICETOKEN:DEVICE_TOKEN_HERE
X-DEVICEID:DEVICE_SERIAL_HERE

Body:

リクエストボディは以下のようなform-urlエンコードペイロード形式で指定してください。

(API v1.x)sample payload

v=VALUE&v2=VALUE2&v3=VALUE3&v4=VALUE4

(API v2.x)sample payload

{"temp" : 25, "humid" : 50}

HTTP ステータスコード:	説明/レスポンスボディ:

HTTP ステータスコード:	説明/レスポンスボディ:
`200 OK`	OK
`401 Unauthorized`	DEVICE_TOKEN is invalid or NULL.
`201 Created`	NEW_DEVICE_FOUND Created new device.You must map device to channel.
`400 Bad Requeset`	DEVICE_ID_ZERO deivce_id:0 is not allowed.(or device_id:NULL)
`403 Forbidden`	NO_MAPPED_CH Sender device's serial number is not map to channel.
`403 Forbidden`	DEVICE_DISABLED Devices status is disabled.

レートリミットについて

HTTP(S)デバイスコネクタを利用する場合、レートリミット（流量制御）メカニズムが適用されます。

現在、1秒あたり1回のデータ送信に制限されています。

HTTPS/HTTPSデバイスコネクタはMQTTを利用できないデバイスのために用意されています。

MQTTデバイスコネクタの利用を強く推奨します。

curl example

curl -X POST -v -H "X-DEVICETOKEN: <DEVICE_TOKEN>" -H "X-DEVICEID: <DEVICE_ID>" -H "Content-Type: application/x-www-form-urlencoded" -d '{"temp":25}' -k https://m.thingscale.io/post3/