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
`twitter`	(オプション) ThingTweetにリンクされたTwitter^®ユーザー名	string
`tweet`	(オプション) Twitterステータス更新	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

本文

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

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

123をチャネルのフィールド 1 に書き込み、既存の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コマンドの実行が成功したことを示しています。

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

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