Main Content

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

Get Alert History

HTTP GETでアラート履歴を取得する

このページをすべて展開する

要求

HTTP メソッド

GET

URL

https://api.thingspeak.com/alerts/history

URLパラメーター

名前優先順位説明

count

オプション

返される結果の数。デフォルト値は 10、最大値は 100 です。

after

オプションこの時点より後のrequested_atの履歴アイテムのみを含めます。ISO 8601 に準拠したフォーマット時間。たとえば、2020-05-15T20:03:48-05:00 は、2020 年 5 月 15 日の 20:03:48 EST を表します。タイムゾーン オフセットを含めない場合、 ThingSpeak は指定された時刻が UTC であると想定します。メモ: アラート履歴アイテムは 7 日間のみ保持され、その後は使用できなくなります。

before

オプションこの時点より前のrequested_atの履歴アイテムのみを含めます。ISO 8601 に準拠したフォーマット時間。たとえば、2020-05-15T20:03:48-05:00 は、2020 年 5 月 15 日の 20:03:48 EST を表します。タイムゾーン オフセットを含めない場合、 ThingSpeak は指定された時刻が UTC であると想定します。メモ: アラート履歴アイテムは 7 日間のみ保持され、その後は使用できなくなります。

subject_contains

オプションこの値を含む件名を持つ履歴アイテムのみを含めます (大文字と小文字は区別されます)。

status

オプションこの値を含むステータスを持つ履歴アイテムのみを含めます。

≪例:≫ https://api.thingspeak.com/alerts/history?count=10

ヘッダー

名前優先順位説明値のタイプ
ThingSpeak-Alerts-API-Key必須

アラート API キーを指定します。これはprofileにあります。このキーは、チャネルAPI キーやユーザー API キーとは異なります。

string

Bodyパラメーター

この API 呼び出しに使用できるbodyパラメーターはありません。

対応

成功

HTTPステータスコード

200 OK

エラー

Acceptヘッダーを使用して、エラー メッセージで提供される詳細を制御できます。Acceptヘッダーとキーapplication/json,application/problem+jsonを指定すると、サーバーは標準の HTTP 応答コードとともに詳細なエラー メッセージを返します。

考えられる HTTP エラーの完全なリストについては、 エラー コードを参照してください。

例

すべて展開する

MATLAB®を使用すると、過去 7 日間のアラート履歴を読み取ることができます。この例では、HTTP要求を作成してアラート履歴を生成する方法を示します。次のコードは、 MATLAB MATLAB をMATLAB環境で記述できることに注意してください。

アラート API キーと要求の URL を設定します。アラート API キーはAccount > My Profileにあります。

apiKey = 'XXXXXXXXXXXXXXXX';
history_url = "https://api.thingspeak.com/alerts/history"

アラート送信要求には API キー ヘッダーが必要です。weboptionsをビルドして、 webreadが HTTP要求を適切に書き込めるようにします。メールのbodyと件名も作成します。

options = weboptions("HeaderFields", ["ThingSpeak-Alerts-API-Key", apiKey ]);

履歴の取得要求を行うには、webread (MATLAB)を使用します。

myHistoryStruct = webread(history_url, options);

Web要求は構造体を返します。struct2table (MATLAB)、 datetime (MATLAB)、およびtable2timetable (MATLAB)を使用して、出力を見やすい形式に書き換えます。

history = struct2table(myHistoryStruct, "AsArray", true);
history.requestedAt = datetime(history.requestedAt, 'InputFormat', "uuuu-MM-dd'T'HH:mm:ss.SSSz", 'TimeZone',"America/New_York");
history = table2timetable(history)
history =

  2×3 timetable

        requestedAt                    sentAt                        subject               status 
    ____________________    ____________________________    __________________________    ________

    18-Dec-2019 13:46:48    {'2019-12-18T18:46:54.160Z'}    {'Plant soil information'}    {'sent'}
    18-Dec-2019 13:43:36    {'2019-12-18T18:43:42.032Z'}    {'Plant soil information'}    {'sent'}

参考

関数

トピック