Main Content

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

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

Body

名前説明値のタイプ
api_key

(必須) この特定のチャネルの API キーを書き込みます。THINGSPEAKAPIKEY HTTP ヘッダーを使用して書き込み API キーを送信することもできます。書き込み API キーは、チャネルビューのAPI Keysタブにあります。

文字列

field<X>

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

どれでも
lat

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

10進数

long

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

10進数
elevation

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

整数
status

(オプション) ステータス更新メッセージ。

文字列
twitter(オプション) ThingTweetにリンクされたTwitter®ユーザー名文字列
tweet(オプション) Twitterステータス更新文字列
created_at

(オプション) フィード エントリが作成された日付 ( ISO 8601形式)。例:2014-12-31 23:59:59。指定する日付はチャネル内で一意である必要があります。タイムゾーンは timezoneパラメーターを使用して指定できます。

datetime

Content-Type

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

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

application/json (JSON 形式の更新)。

応答

成功

HTTPステータスコード

200 OK

Body

 テキストの例

 JSON の例

 XML の例

エラー

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

制限

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

すべて展開する

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を使用すると、 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-urlencodedBody」を選択します。

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

  5. Parameter field1Value 123 を入力します。

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

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!" 
}