Write Data and Execute TalkBack Command

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

要求

POST または GET

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

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

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

名前	説明	値のタイプ
`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 はPOST メソッドにのみ必要であり、 GETメソッドには必要ありません。

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

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

HTTPステータスコード

200 OK

Body

テキスト例

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

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コマンドの実行が成功したことを示します。

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

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