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

Get Alert History

Rufen Sie den Alarmverlauf mit HTTP GET ab

alle in Seite erweitern

Anfrage

HTTP-Methode

GET

URL

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

URL-Parameter

Name	Priorität	Beschreibung
`count`	Optional	Die Anzahl der zurückzugebenden Ergebnisse. Der Standardwert ist 10, der Maximalwert ist 100.
`after`	Optional	Schließen Sie nach diesem Zeitpunkt nur Verlaufselemente mit `requested_at` ein. Formatierungszeiten 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 angeben, geht ThingSpeak davon aus, dass die angegebene Zeit in UTC angegeben ist. Notiz: Elemente des Alarmverlaufs werden nur 7 Tage lang aufbewahrt und sind danach nicht mehr verfügbar.
`before`	Optional	Schließen Sie nur Verlaufselemente mit `requested_at` vor diesem Zeitpunkt ein. Formatierungszeiten 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 angeben, geht ThingSpeak davon aus, dass die angegebene Zeit in UTC angegeben ist. Notiz: Elemente des Alarmverlaufs werden nur 7 Tage lang aufbewahrt und sind danach nicht mehr verfügbar.
`subject_contains`	Optional	Schließen Sie nur Verlaufselemente ein, deren Betreff diesen Wert enthält. Beachten Sie dabei die Groß- und Kleinschreibung.
`status`	Optional	Schließen Sie nur Verlaufselemente ein, deren Status diesen Wert enthält.

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

Überschriften

Name	Priorität	Beschreibung	Werttyp
`ThingSpeak-Alerts-API-Key`	Erforderlich	Geben Sie den Warnungs-API-Schlüssel an, den Sie in Ihrem profile 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

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

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

Beispiele

alle erweitern

Alarmverlauf mit MATLAB anzeigen

Mit MATLAB^® können Sie Ihren Alarmverlauf der letzten 7 Tage lesen. Dieses Beispiel zeigt, wie Sie eine HTTP-Anfrage stellen, um Ihren Warnmeldungsverlauf 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 Warnungs-API-Schlüssel und die URL für die Anfrage fest. Ihr API-Schlüssel für Warnungen 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 außerdem den E-Mail-Text und den Betreff.

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

Verwenden Sie webread (MATLAB) , um die Anforderung 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 übersichtlichere 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'}