Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l’originale in inglese.

Get Alert History

Ottieni la cronologia degli avvisi con HTTP GET

espandi tutto nella pagina

Richiesta

Metodo HTTP

GET

URL

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

Parametri URL

Nome	Priorità	Descrizione
`count`	Opzionale	Il numero di risultati da restituire. Il valore predefinito è 10, il valore massimo è 100.
`after`	Opzionale	Includi solo gli elementi della cronologia con `requested_at` successivi a questo orario. Tempi di formato secondo ISO 8601. Ad esempio, 2020-05-15T20:03:48-05:00 rappresenta il 15 maggio 2020, 20:03:48 EST. Se non includi la differenza del fuso orario, ThingSpeak presuppone che l'ora specificata sia UTC. Nota: gli elementi della cronologia degli avvisi vengono conservati solo per 7 giorni, dopodiché non sono più disponibili.
`before`	Opzionale	Includi solo gli elementi della cronologia con `requested_at` precedenti a questo orario. Tempi di formato secondo ISO 8601. Ad esempio, 2020-05-15T20:03:48-05:00 rappresenta il 15 maggio 2020, 20:03:48 EST. Se non includi la differenza del fuso orario, ThingSpeak presuppone che l'ora specificata sia UTC. Nota: gli elementi della cronologia degli avvisi vengono conservati solo per 7 giorni, dopodiché non sono più disponibili.
`subject_contains`	Opzionale	Include solo elementi della cronologia con oggetto contenente questo valore, con distinzione tra maiuscole e minuscole.
`status`	Opzionale	Include solo gli elementi della cronologia con stato contenente questo valore.

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

Intestazioni

Nome	Priorità	Descrizione	Tipo di valore
`ThingSpeak-Alerts-API-Key`	Necessario	Specifica la chiave API degli avvisi, che puoi trovare nel tuo profile. Questa chiave è diversa dalle chiavi API del canale e dalle chiavi API utente.	stringa

Parametri del corpo

Non sono disponibili parametri del corpo per questa chiamata API.

Risposta

Successo

Codice di stato HTTP

200 OK

Errore

È possibile utilizzare l'intestazione Accept per controllare i dettagli forniti con i messaggi di errore. Fornisci l'intestazione Accept e la chiave application/json,application/problem+json e il server restituirà messaggi di errore dettagliati insieme al codice di risposta HTTP standard.

Per l'elenco completo dei possibili errori HTTP, vedere Codici di errore.

Esempi

espandi tutto

Visualizza la cronologia degli avvisi utilizzando MATLAB

Puoi utilizzare MATLAB^® per leggere la cronologia degli avvisi degli ultimi 7 giorni. Questo esempio mostra come effettuare una richiesta HTTP per generare la cronologia degli avvisi. Tieni presente che puoi scrivere il codice seguente in qualsiasi ambiente MATLAB , inclusi MATLAB Analysis e desktop MATLAB.

Imposta la chiave API degli avvisi e l'URL per la richiesta. La chiave API degli avvisi si trova in Account > My Profile.

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

La richiesta di invio degli avvisi richiede un'intestazione della chiave API. Costruisci weboptions in modo che webread possa scrivere in modo appropriato la tua richiesta HTTP. Crea anche il corpo e l'oggetto dell'email.

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

Utilizzare webread (MATLAB) per effettuare la richiesta di recupero della cronologia.

myHistoryStruct = webread(history_url, options);

La richiesta web restituisce una struttura. Utilizzare struct2table (MATLAB), datetime (MATLAB) e table2timetable (MATLAB) per riscrivere l'output in un modulo più semplice da visualizzare.

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