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

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 キーを指定します。このキーは、チャネルAPI キーやユーザー API キーとは異なります。

string

Bodyパラメーター

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

応答

成功

HTTPステータスコード

200 OK

エラー

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

発生する可能性のある HTTP エラーの完全なリストについては、エラーコード を参照してください。

例

すべて展開する

MATLAB® を使用すると、過去 7 日間のアラート履歴を読むことができます。この例では、アラート履歴を生成するための HTTP要求を作成する方法を示します。次のコードは、MATLAB Analysis やデスクトップ MATLAB を含む任意の MATLAB 環境で記述できることに注意してください。

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

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

アラート送信要求には API キー ヘッダーが必要です。webread が HTTP要求を適切に書き込めるように weboptions をビルドします。メールの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'}

参考

関数

トピック