Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

チャネル フィードの更新

チャネル フィードを更新するには、HTTP GET または HTTP POST を https://api.thingspeak.com/update に送信します。

有効なパラメーターは次のとおりです。

  • api_key (文字列) - この特定のチャネルの Write API キー (必須)。オプションで、Write API キーは THINGSPEAKAPIKEY HTTP ヘッダーを介して送信できます。

  • field1 (文字列) - Field 1 のデータ (オプション)

  • field2 (文字列) - Field 2 のデータ (オプション)

  • field3 (文字列) - Field 3 のデータ (オプション)

  • field4 (文字列) - Field 4 のデータ (オプション)

  • field5 (文字列) - Field 5 のデータ (オプション)

  • field6 (文字列) - Field 6 のデータ (オプション)

  • field7 (文字列) - Field 7 のデータ (オプション)

  • field8 (文字列) - Field 8 のデータ (オプション)

  • lat (10 進数) - 度単位の緯度 (オプション)

  • long (10 進数) - 度単位の経度 (オプション)

  • elevation (整数) - メートル単位での標高 (オプション)

  • status (文字列) - ステータス更新メッセージ (オプション)

  • twitter (文字列) - ThingTweet にリンクされた Twitter® のユーザー名 (オプション)

  • tweet (文字列) - Twitter のステータス更新 (オプション)

  • created_at (日時) - このフィード エントリが作成された日付 (ISO 8601 形式、例: 2014-12-31 23:59:59)。タイム ゾーンは timezone パラメーターで指定できます (オプション)

テキスト

POST の例:

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

応答は更新のエントリ ID です。例: 18

更新が失敗した場合の応答は 0 です。

JSON

チャネル フィードを更新するには、HTTP GET または HTTP POST を https://api.thingspeak.com/update.json に送信します。

POST の例:

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

チャネル フィードを更新するには、HTTP GET または HTTP POST を https://api.thingspeak.com/update.xml に送信します。

POST の例:

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>

関連するトピック