Main Content

Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

Send Alert

Crea avviso e-mail con HTTP POST

Richiesta

Metodo HTTP

POST

URL

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

Parametri URL

Nessun parametro disponibile

Intestazioni

Le intestazioni ThingSpeak-Alerts-API-Key e Content-Type sono obbligatorie. L'intestazione Accept è facoltativa.

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

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

Content-TypeNecessario

  • application/json

  • application/x-www-form-urlencoded

stringa

Parametri del corpo

NomePrioritàDescrizioneTipo di valore
subjectOpzionale

Specificare l'oggetto del messaggio e-mail, fino a 60 caratteri.

stringa

bodyOpzionale

Specificare il corpo del messaggio e-mail, fino a 500 caratteri.

stringa

Risposta

Successo

Codice di stato HTTP

202 Accepted

Errore

È possibile utilizzare l'intestazione Accept per controllare i dettagli forniti con i messaggi di errore. Fornisci l'intestazione Accept con il valore 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

Utilizza POSTMAN per effettuare richieste HTTP utilizzando l'API RESTful per ThingSpeak.

Crea un avviso con un oggetto e un corpo dettagliati.

  1. Crea la richiesta POST. In POSTMAN, seleziona POST dall'elenco dei verbi HTTP e inserisci https://api.thingspeak.com/alerts/send nella barra degli indirizzi.

  2. Inserisci le intestazioni. Seleziona la scheda Headers . Inserisci queste coppie chiave-valore.

    ChiaveValore
    Thingspeak-Alerts-API-KeyXXXXXXXXXXXXXXXX
    Content-Typeapplication/json

  3. Inserisci le informazioni sul corpo. Seleziona la scheda Body e seleziona raw. Inserisci questo codice JSON.

    {
        "subject": "ThingSpeak Alert email",
        "body": "The water level has reached its limit"
    }

La risposta è in formato JSON. Il valore della risposta del server è 202 OK, che indica una richiesta accettata. L'e-mail viene inviata poco dopo.

Utilizzare MATLAB® per generare un avviso quando il valore medio in un canale è superiore a una soglia impostata. Questo esempio utilizza ThingSpeak channel 276330, che contiene i dati sulla temperatura dell'ufficio in tempo reale nel campo 7. Tieni presente che puoi scrivere il codice seguente in qualsiasi ambiente MATLAB , inclusi MATLAB Analysis e MATLAB desktop.

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

Leggere i dati dal canale e calcolare il valore medio dei dati.

data = thingSpeakRead(276330,"NumMinutes", 100);
aveTemp = mean(data(:, 7));

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';
alertURL = "https://api.thingspeak.com/alerts/send";

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

Suggerimento

Quando crei un avviso in MATLAB utilizzando webwrite, l'intestazione Content-Type richiesta viene specificata automaticamente.

options = weboptions("HeaderFields", ["ThingSpeak-Alerts-API-Key", apiKey ]);
alertBody = sprintf("The temperature is %0.2f°F.", aveTemp);
alertSubject = sprintf("🌡 Temperature exceeded 60.0°F!");

Se la temperatura è più calda di 60 °F, invia un avviso.

if aveTemp > 60.0
    webwrite(alertURL, "body", alertBody, "subject", alertSubject, options);
end    

Il timestamp utilizzato nell'e-mail è nel fuso orario impostato nelle Impostazioni ThingSpeak , che puoi trovare in Account > My Profile. Puoi utilizzare la chiamata API Get Alert History per monitorare lo stato della tua email.

Ora puoi utilizzare l'app TimeControl per pianificare l'esecuzione di questo codice a intervalli regolari. Vai a Apps > TimeControl e seleziona il nuovo TimeControl. Imposta Frequency su Ricorrente e Recurrence su 100 minuti. Seleziona l'analisi Action come analisi MATLAB e scegli il nome dell'analisi MATLAB che hai scritto nel passaggio precedente. Salva il controllo temporale.

Quando la temperatura media supera i 60 ℉, riceverai un'e-mail da ThingSpeak.

Limitazioni

  • Gli utenti sono limitati a 2 avvisi ogni 30 minuti. Il limite di velocità viene applicato al momento della richiesta, non al momento dell'invio dell'e-mail. Se superi il limite di richieste, l'API restituisce il codice di risposta 429.