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.
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 |
Content-Type | Necessario |
| stringa |
Parametri del corpo
Nome | Priorità | Descrizione | Tipo di valore |
---|---|---|---|
subject | Opzionale | Specificare l'oggetto del messaggio e-mail, fino a 60 caratteri. | stringa |
body | Opzionale | Specificare il corpo del messaggio e-mail, fino a 500 caratteri. | stringa |
Risposta
Successo
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
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.