このページは機械翻訳を使用して翻訳されました。元の英語を参照するには、ここをクリックします。
Write Settings
HTTP PUT を使用してチャネル設定を更新する
要求
説明
この要求を使用してチャネル設定を書き込みます。チャネル設定には、チャネルの説明、フィールド名、チャネルの場所、メタデータ、パブリックまたはプライベートのステータス、およびチャネルの名前が含まれます。
HTTP メソッド
PUT
URL
https://api.thingspeak.com/channels/
<channel_id>
.<format>
URLパラメーター
名前 | 説明 |
---|---|
| (必須) 対象のチャネルのチャネルID。 |
| (必須) HTTP 応答の形式。 |
例: https://api.thingspeak.com/channels/266256.json
Bodyパラメーター
名前 | 説明 | 値のタイプ |
---|---|---|
api_key | (必須) ユーザー API キーを指定します。これはprofileにあります。このキーはチャネルAPI キーとは異なります。 | string |
description | (オプション)チャネルの説明。 | string |
field1 | (オプション) フィールド 1 の名前。 | 文字列> |
field<X> | (オプション) フィールド X 名。X はフィールド ID です。 | string |
latitude | (オプション) 度単位の緯度。 | 小数 |
longitude | (オプション) 度単位の経度。 | 小数 |
elevation | (オプション) メートル単位の標高。 | 整数 |
metadata | (オプション)チャネルのメタデータ。JSON、XML、またはその他のデータを含めることができます。 | テキスト |
name | (オプション)チャネルの名前。 | string |
public_flag | (オプション)チャネルがパブリックかどうか。デフォルトは false です。 | true または false |
tags | (オプション) タグのカンマ区切りリスト。 | string |
url | (オプション)チャネルの Web ページ URL。 | string |
Content-Type
application/x-www-form-urlencoded
例
POSTMANを使用してチャネル設定を書き込む
POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。この例では、 POSTMANを使用して新しいチャネル設定を書き込む方法を示します。
既存のチャネルを使用して、チャネル名をUpdated Channel
に変更し、フィールド 1 タイトルをHeart Rate
に変更します。また、共有をパブリックに変更します。
PUT https://api.thingspeak.com/channels/CHANNEL_ID api_key=XXXXXXXXXXXXXXXX name=Updated Channel public_flag=true field1=Heart Rate
POSTMANで、HTTP 動詞のドロップダウン リストから PUT を選択し、アドレス バーに
api.thingspeak.com/channels/<CHANNEL_ID>.json
と入力し、<CHANNEL_ID>
を対象のチャネルに置き換えます。値列にパラメーター
api_key
を入力し、 Account > My Profileにあるユーザー API キーを入力します。追加のパラメーターと値を入力します。
name
, Value:Updated Channel
field1
, Value:Heart Rate
public_flag
, Value:True
応答は JSON 形式です。新しいチャネル設定の書き込みが成功したことを示す、サーバー応答値 200 OK に注目してください。
新しいチャネル設定がchannelsページで利用できるようになりました。