...
もしRESTインタフェースを利用してバルクデータを送信したい場合は,APIリファレンス /wiki/spaces/TD/pages/8454146 を参照してください。
HTTP/HTTPSでデバイスからプラットフォームへストリームを送信する
...
HTTP/HTTPS Endpoint
URI | HTTPメソッド | API version |
|---|
| POST | 1.x |
| POST | 2.x |
パラメータ
| Expand |
|---|
|
リクエストパラメータ | 説明 |
|---|
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エンコードペイロード形式で指定してください。 |
| Code Block |
|---|
title | (API v1.x)sample payload| Code Block |
|---|
v=VALUE&v2=VALUE2&v3=VALUE3&v4=VALUE4 |
|
codetitle | | language | js |
|---|
(API v2.x)sample payload| Code Block |
|---|
| {"temp" : 25, "humid" : 50} |
|
|
| Expand |
|---|
|
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
| Code Block |
|---|
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/ |
...