Diese Seite wurde mithilfe maschineller Übersetzung übersetzt. Klicken Sie hier, um die neueste Version auf Englisch zu sehen.

Get Alert History

Holen Sie sich den Alarmverlauf mit HTTP GET

alle in Seite erweitern

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

NamePrioritätBeschreibung

count

Optional

Die Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 10, der Maximalwert ist 100.

after

OptionalSchließen Sie nur Verlaufselemente mit requested_at ein, die nach diesem Zeitpunkt liegen. Formatieren Sie die Zeiten gemäß ISO 8601. Beispielsweise steht 2020-05-15T20:03:48-05:00 für den 15. Mai 2020, 20:03:48 EST. Wenn Sie den Zeitzonenversatz nicht einschließen, geht ThingSpeak davon aus, dass die angegebene Zeit in UTC ist. Hinweis: Elemente im Warnverlauf werden nur 7 Tage lang gespeichert und sind danach nicht mehr verfügbar.

before

OptionalSchließen Sie nur Verlaufselemente mit requested_at ein, die vor diesem Zeitpunkt liegen. Formatieren Sie die Zeiten gemäß ISO 8601. Beispielsweise steht 2020-05-15T20:03:48-05:00 für den 15. Mai 2020, 20:03:48 EST. Wenn Sie den Zeitzonenversatz nicht einschließen, geht ThingSpeak davon aus, dass die angegebene Zeit in UTC ist. Hinweis: Elemente im Warnverlauf werden nur 7 Tage lang gespeichert und sind danach nicht mehr verfügbar.

subject_contains

OptionalSchließen Sie nur Verlaufselemente mit dem Betreff ein, der diesen Wert enthält. Dabei wird auf Groß- und Kleinschreibung geachtet.

status

OptionalSchließen Sie nur Verlaufselemente mit einem Status ein, der diesen Wert enthält.

Beispiel: https://api.thingspeak.com/alerts/history?count=10

Überschriften

NamePrioritätBeschreibungWerttyp
ThingSpeak-Alerts-API-KeyErforderlich

Geben Sie den API-Schlüssel für Warnungen an, den Sie in Ihrem Profil finden. Dieser Schlüssel unterscheidet sich von den Kanal-API- und Benutzer-API-Schlüsseln.

Zeichenfolge

Körperparameter

Für diesen API-Aufruf sind keine Body-Parameter verfügbar.

Antwort

Erfolg

HTTP-Statuscode

200 OK

Fehler

Mit dem Header Accept können Sie die in den Fehlermeldungen bereitgestellten Details steuern. Geben Sie den Header Accept und den Schlüssel application/json,application/problem+json an und der Server gibt ausführliche Fehlermeldungen zusammen mit dem Standard-HTTP-Antwortcode zurück.

Die vollständige Liste möglicher HTTP-Fehler finden Sie unter Fehlercodes.

Beispiele

alle erweitern

Mit MATLAB® können Sie Ihren Alarmverlauf der letzten 7 Tage lesen. Dieses Beispiel zeigt, wie Sie eine HTTP-Anfrage stellen, um Ihren Warnverlauf zu generieren. Beachten Sie, dass Sie den folgenden Code in jeder MATLAB-Umgebung schreiben können, einschließlich MATLAB Analysis und Desktop MATLAB.

Legen Sie den API-Schlüssel für Warnungen und die URL für die Anfrage fest. Ihr API-Schlüssel für Benachrichtigungen befindet sich unter Account > My Profile.

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

Für die Anforderung zum Senden von Warnungen ist ein API-Schlüsselheader erforderlich. Erstellen Sie weboptions, damit webread Ihre HTTP-Anfrage entsprechend schreiben kann. Erstellen Sie auch den E-Mail-Text und den Betreff.

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

Verwenden Sie webread (MATLAB), um die Anfrage zum Abrufen des Verlaufs zu stellen.

myHistoryStruct = webread(history_url, options);

Die Webanforderung gibt eine Struktur zurück. Verwenden Sie struct2table (MATLAB), datetime (MATLAB) und table2timetable (MATLAB), um die Ausgabe in eine besser lesbare Form umzuschreiben.

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'}

Siehe auch

Funktionen

Themen