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

NomePrioritàDescrizione

count

Opzionale

Numero di risultati da restituire. Il valore predefinito è 10, il valore massimo è 100.

after

OpzionaleIncludi solo gli elementi della cronologia con requested_at successivi a questo orario. Tempi di formattazione secondo ISO 8601. Ad esempio, 2020-05-15T20:03:48-05:00 rappresenta il 15 maggio 2020, 20:03:48 EST. Se non si include la differenza di fuso orario, ThingSpeak presuppone che l'ora specificata sia in UTC. Nota: Gli elementi della cronologia degli avvisi vengono conservati solo per 7 giorni, dopodiché non sono più disponibili.

before

OpzionaleIncludi solo gli elementi della cronologia con requested_at precedenti a questo orario. Tempi di formattazione secondo ISO 8601. Ad esempio, 2020-05-15T20:03:48-05:00 rappresenta il 15 maggio 2020, 20:03:48 EST. Se non si include la differenza di fuso orario, ThingSpeak presuppone che l'ora specificata sia in UTC. Nota: Gli elementi della cronologia degli avvisi vengono conservati solo per 7 giorni, dopodiché non sono più disponibili.

subject_contains

OpzionaleIncludi solo gli elementi della cronologia con oggetto contenente questo valore, prestando attenzione alle maiuscole e alle minuscole.

status

OpzionaleIncludi solo gli elementi della cronologia con stato contenente questo valore.

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

Intestazioni

NomePrioritàDescrizioneTipo di valore
ThingSpeak-Alerts-API-KeyNecessario

Specifica la chiave API degli avvisi, che puoi trovare nel tuo profilo. Questa chiave è diversa dalle chiavi API del canale e API dell'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

Puoi usare 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 seguente codice 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. Compila weboptions in modo che webread possa scrivere correttamente la tua richiesta HTTP. Crea anche il corpo e l'oggetto dell'e-mail.

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

Utilizzare webread (MATLAB) per effettuare la richiesta di ottenere la 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 formato più facile 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'}

Vedi anche

Funzioni

Argomenti