このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

Write Data and Execute TalkBack Command

HTTP GETまたはPOSTでチャネルデータを更新し、 TalkBackコマンドを実行します。

このページをすべて展開する

要求

HTTPメソッド

POST または GET

URL

https://api.thingspeak.com/update.<format>

URLパラメーター

名前	説明
`<format>`	HTTP 応答の形式。`json` または `xml` として指定されます。

例: https://api.thingspeak.com/update.json?api_key=XXXXXXXXXXXXXXXXtalkback_key=YYYYYYYYYYYYYYYY

Body

名前	説明	値のタイプ
`api_key`	(必須) この特定のチャネルの書き込み API キーを指定します。THINGSPEAKAPIKEY HTTP ヘッダーを使用して書き込み API キーを送信することもできます。書き込み API キーは、チャネルビューの API Keys タブにあります。	string
`talkback_key`	(必須) TalkBackの特定のインスタンスの API キー。TalkBack API キーを含めると、キュー内の次のコマンドが削除され、応答でコマンドが返されます。	string
`field<X>`	（オプション）フィールドXデータ（XはフィールドID）	任意
`lat`	（オプション）緯度（度）	小数
`long`	（オプション）経度（度）	小数
`elevation`	（オプション）標高（メートル）	整数
`status`	（オプション）ステータス更新メッセージ	string
`created_at`	(オプション) フィードエントリが作成された日付 (ISO 8601 形式、例: `2014-12-31 23:59:59`)。チャネル内で一意である必要があります。タイムゾーンは、timezoneパラメーターを使用して指定できます。	datetime

Content-Type

Content-Type はPOST メソッドにのみ必要であり、 GETメソッドには必要ありません。

JSON 形式での更新には application/json を使用します。

その他のすべての更新には application/x-www-form-urlencoded を使用してください。

応答

成功

HTTPステータスコード

200 OK

Body

テキスト例

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     field1=73
     talkback_key=YYYYYYYYYYYYYYYY

応答

応答は、指定されたTalkBack API キーを持つTalkBackキュー内の次のTalkBackコマンドのコマンド文字列です。

更新に失敗した場合、応答は 0 になります。

JSONの例

POST https://api.thingspeak.com/update.json
     api_key=XXXXXXXXXXXXXXXX
     field1=73
     talkback_key=YYYYYYYYYYYYYYYY

応答は、指定されたTalkBack API キーを持つTalkBackキュー内の次のコマンドの JSON オブジェクトです。次に例を示します。

{
"id": 15254213,
"command_string": "OPENDOOR",
"position": null,
"executed_at": "2019-03-05T15:48:29Z",
"created_at": "2019-02-26T13:45:09Z"
}

XMLの例

POST https://api.thingspeak.com/update.xml
     api_key=XXXXXXXXXXXXXXXX
     field1=73
     talkback_key=YYYYYYYYYYYYYYYY

応答は、指定されたTalkBack API キーを持つTalkBackキュー内の次のコマンドの XML オブジェクトです。次に例を示します。

<command>
<id type="integer">15338752</id>
<command-string>OPENDOOR</command-string>
<position type="integer" nil="true"/>
<executed-at type="dateTime">2019-03-05T15:52:08Z</executed-at>
<created-at type="dateTime">2019-03-05T15:51:54Z</created-at>
</command>

エラー

完全なリストについては、エラーコードを参照してください。

例

すべて展開する

POSTMANを使用してTalkBackコマンドを追加する

POSTMAN を使用すると、ThingSpeak の RESTful API を使用して HTTP要求を試すことができます。この例では、 POSTMANを使用してチャネルを同時に更新し、既存のキューからTalkBackコマンドを実行する方法を示します。

チャネルのフィールド 1 に 123 を書き込み、既存のTalkBackキュー内の次のTalkBackコマンドを返します。

POST https://api.thingspeak.com/update
     api_key=XXXXXXXXXXXXXXXX
     talkback_key=YYYYYYYYYYYYYYYYY

POSTMANで、HTTP 動詞のドロップダウンリストから POST を選択し、アドレスバーに https://api.thingspeak.com/update と入力します。
追加のパラメーターと値を入力します。
- Key: api_key、Value: XXXXXXXXXXXXXXXX
- Key: talkback_key、Value: YYYYYYYYYYYYYYYY

応答はテキスト形式です。サーバー応答値 200 OK に注意してください。これは、チャネルの更新とTalkBackコマンドの実行が成功したことを示します。

実行されたコマンドは応答に表示されます。

制限

タイムスタンプはすべて一意でなければなりません。チャネル内の既存のデータと一致するタイムスタンプを使用して新しいデータを書き込むことはできません。

参考