Send Alert
Créer une alerte email avec HTTP POST
Requête
Méthode HTTP
POST
URL
https://api.thingspeak.com/alerts/send
Paramètres d'URL
Aucun paramètre disponible
En-têtes
Les en-têtes ThingSpeak-Alerts-API-Key
et Content-Type
sont obligatoires. L'en-tête Accept
est facultatif.
Nom | Priorité | Description | Type de valeur |
---|---|---|---|
ThingSpeak-Alerts-API-Key | Requis | Spécifiez la clé d'API des alertes, que vous pouvez trouver dans votre profile. Cette clé est différente des clés d'API de canal et d'API d'utilisateur. | chaîne de caractère |
Content-Type | Requis |
| chaîne de caractère |
Paramètres du corps de la requête
Nom | Priorité | Description | Type de valeur |
---|---|---|---|
subject | Facultatif | Spécifiez l'objet du message électronique, jusqu'à 60 caractères. | chaîne de caractère |
body | Facultatif | Spécifiez le corps du message électronique, jusqu'à 500 caractères. | chaîne de caractère |
Réponse
Succès
202 Accepted
Erreur
Vous pouvez utiliser l'en-tête Accept
pour contrôler les détails fournis avec les messages d'erreur. Fournissez l'en-tête Accept
avec la valeur application/json,application/problem+json
et le serveur renvoie des messages d'erreur détaillés ainsi que le code de réponse HTTP standard.
Pour la liste complète des erreurs HTTP possibles, voir Codes d'erreur.
Exemples
Limites
Les utilisateurs sont limités à 2 alertes toutes les 30 minutes. La limite de débit est appliquée au moment de la requête, et non au moment de l'envoi de l'e-mail. Si vous dépassez la limite de requêtes, l'API renvoie le code de réponse 429.