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

Write Data

HTTP GETまたは POST を使用してチャネルデータを更新します

要求

HTTP メソッド

POST または GET

URL

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

URLパラメーター

名前	説明
<format>	(必須) HTTP 応答の形式。空白、 json、またはxmlとして指定します。

例:https://api.thingspeak.com/update.json

本文

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

Content-Type

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

ほとんどのアップデートについてはapplication/x-www-form-urlencoded。

JSON 形式での更新の場合はapplication/json。

対応

成功

HTTPステータスコード

200 OK

本文

 テキストの例

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

対応 応答は更新のエントリ ID です。次に例を示します。18. 更新が失敗した場合、応答は 0 になります。

 JSON の例

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

応答は、新しいエントリの JSON オブジェクトです。次に例を示します。 { "channel_id": 3, "field1": '73', "field2": null, "field3": null, "field4": null, "field5": null, "field6": null, "field7": null, "field8": null, "created_at": '2014-02-25T14:13:01-05:00', "entry_id": 320, "status": null, "latitude": null, "longitude": null, "elevation": null }

 XML の例

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

応答は、新しいエントリの XML オブジェクトです。次に例を示します。 <?xml version="1.0" encoding="UTF-8"?> <feed> <channel-id type="integer">3</channel-id> <field1>73</field1> <field2 nil="true"/> <field3 nil="true"/> <field4 nil="true"/> <field5 nil="true"/> <field6 nil="true"/> <field7 nil="true"/> <field8 nil="true"/> <created-at type="dateTime">2014-02-25T14:15:42-05:00</created-at> <entry-id type="integer">321</entry-id> <status nil="true"/> <latitude type="decimal" nil="true"/> <longitude type="decimal" nil="true"/> <elevation nil="true"/> </feed>

エラー

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

制限

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

例

GETでデータを書き込む

Web ブラウザを使用して、 ThingSpeak™の RESTful API へのGET HTTP要求を完了できます。GET要求を自動的に URL エンコードしない組み込みデバイスまたはクライアントの場合は、デバイスからGET要求を行う前に、明示的にURL encodeクエリパラメーターを実行する必要があることに注意してください。

URL を Web ブラウザのアドレス バーにコピーし、 <write_api_key>をユーザー API キーに変更します。このキーは、 Account > My Profileにあります。

https://api.thingspeak.com/update.json?api_key=<write_api_key>&field1=123

応答は新しいエントリの JSON オブジェクトであり、サーバーからの 200 OK です。

{
    "channel_id": 266256,
    "created_at": "2018-09-10T17:41:59Z",
    "entry_id": 2,
    "field1": "123",
    "field2": null,
    "field3": null,
    "field4": null,
    "field5": null,
    "field6": null,
    "field7": null,
    "field8": null,
    "latitude": null,
    "longitude": null,
    "elevation": null,
    "status": null
}

POSTMAN を使用して POST でデータを書き込む

POSTMANを使用すると、 ThingSpeakの RESTful API を使用した HTTP要求を試すことができます。この例では、 POSTMANを使用してチャネルにデータを書き込む方法を示します。

HTTP要求の形式は次のとおりです。

POST https://api.thingspeak.com/update.json
       api_key=XXXXXXXXXXXXXXXX
       field1=123

1. POSTMANで、HTTP 動詞のドロップダウン リストから POST を選択します。

2. アドレスフィールドに「https://api.thingspeak.com/update.json」と入力します。

3. 「x-www-form-urlencoded 」セクションで「Body」を選択します。

4. Parameter api_keyと書き込み API キーを入力します。これはChannels> API Keysにあります。

5. Parameter field1とValue 123 を入力します。

応答は新しいエントリの JSON オブジェクトであり、サーバーからの 200 OK です。

JSON エンコードされたエントリの書き込み

JSON 形式を使用してデータをチャネルに書き込むことができます。この例は、複数のフィールドとステータス情報を同時に書き込むための JSON 形式の REST 呼び出しを示しています。応答も JSON 形式です。

POST api.thingspeak.com/update.json
Content-Type: application/json
 
{ 
        "api_key": "XXXXXXXXXXXXXXXX"  
        "created_at": "2018-04-23 21:36:20 +0200", 
        "field1": "John Johnson", 
        "field3": 56, 
        "field4": 555, 
        "field5": 444, 
        "latitude": "", 
        "longitude": "", 
        "status": "Please check in!" 
    
}

応答は新しいエントリの JSON オブジェクトであり、サーバーからの 200 OK です。

{
    "channel_id": 12345,
    "created_at": "2018-04-23 21:36:20 +0200", 
    "field1": "John Johnson", 
    "field3": 56, 
    "field4": 555, 
    "field5": 444, 
    "latitude": "", 
    "longitude": "", 
    "status": "Please check in!" 
}

参考

Read Data | Read Field | Read Status | Bulk Write Data

トピック

• チャネルのプロパティ