このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
チャネル フィードの更新
チャネル フィードを更新するには、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>