Main Content

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

Write Settings

HTTP PUT を使用してチャネル設定を更新する

要求

説明

この要求を使用してチャネル設定を書き込みます。チャネル設定には、チャネルの説明、フィールド名、チャネルの場所、メタデータ、パブリックまたはプライベートのステータス、およびチャネルの名前が含まれます。

HTTPメソッド

PUT

URL

https://api.thingspeak.com/channels/<channel_id>.<format>

URLパラメーター

名前説明

<channel_id>

(必須) 対象のチャネルのチャネルID。

<format>

(必須) HTTP 応答の形式。 jsonまたはxmlとして指定します。

≪例:≫ https://api.thingspeak.com/channels/266256.json

Bodyパラメーター

名前説明値のタイプ
api_key(必須) ユーザー API キーを指定します。これはprofileにあります。このキーはチャネルAPI キーとは異なります。文字列
description(オプション)チャネルの説明。文字列
field1

(オプション) フィールド 1 の名前。

文字列>
field<X>

(オプション) フィールド X 名。X はフィールド ID です。

文字列
latitude

(オプション) 度単位の緯度。 -90から90までの値として指定します。

10進数
longitude

(オプション) 度単位の経度。 -180から180までの値として指定します。

10進数
elevation

(オプション) メートル単位の標高。

整数
metadata

(オプション)チャネルのメタデータ。JSON、XML、またはその他のデータを含めることができます。

文章
name

(オプション)チャネルの名前。

文字列
public_flag

(オプション)チャネルがパブリックかどうか。デフォルトは false です。

trueまたはfalse
tags

(オプション) タグのカンマ区切りリスト。

文字列
url

(オプション)チャネルの Web ページ URL。

文字列

Content-Type

application/x-www-form-urlencoded

応答

成功

HTTPステータスコード

200 OK

Body

 JSON の例

 XML の例

エラー

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

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

  1. POSTMANで、HTTP 動詞のドロップダウン リストから PUT を選択し、アドレス バーにapi.thingspeak.com/channels/<CHANNEL_ID>.jsonと入力し、 <CHANNEL_ID>を対象のチャネルに置き換えます。

  2. 値列にパラメーターapi_keyを入力し、 Account > My Profileにあるユーザー API キーを入力します。

  3. 追加のパラメーターと値を入力します。

    • nameValue:Updated Channel

    • field1Value:Heart Rate

    • public_flagValue:True

応答は JSON 形式です。新しいチャネル設定の書き込みが成功したことを示す、サーバー応答値 200 OK に注目してください。

新しいチャネル設定がchannelsページで利用できるようになりました。

追加資料