Cette page a été traduite par traduction automatique. Cliquez ici pour voir la version originale en anglais.

Get Alert History

Obtenir l'historique des alertes avec HTTP GET

développer tous les éléments de la page

Requête

Méthode HTTP

GET

URL

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

Paramètres d'URL

NomPrioritéDescription

count

Facultatif

Le nombre de résultats à renvoyer. La valeur par défaut est 10, la valeur maximale est 100.

after

FacultatifInclure uniquement les éléments d'historique avec requested_at postérieurs à cette heure. Temps de format selon ISO 8601. Par exemple, 2020-05-15T20:03:48-05:00 représente le 15 mai 2020, 20:03:48 EST. Si vous n'incluez pas le décalage de fuseau horaire, ThingSpeak suppose que l'heure spécifiée est en UTC. Note: Les éléments de l'historique des alertes ne sont conservés que 7 jours, après quoi ils ne sont plus disponibles.

before

FacultatifInclure uniquement les éléments d'historique avec requested_at antérieurs à cette heure. Temps de format selon ISO 8601. Par exemple, 2020-05-15T20:03:48-05:00 représente le 15 mai 2020, 20:03:48 EST. Si vous n'incluez pas le décalage de fuseau horaire, ThingSpeak suppose que l'heure spécifiée est en UTC. Note: Les éléments de l'historique des alertes ne sont conservés que 7 jours, après quoi ils ne sont plus disponibles.

subject_contains

FacultatifN'incluez que les éléments d'historique dont le sujet contient cette valeur, sensible à la casse.

status

FacultatifN'incluez que les éléments d'historique dont le statut contient cette valeur.

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

Headers

NomPrioritéDescriptionType de valeur
ThingSpeak-Alerts-API-KeyRequis

Spécifiez la clé API des alertes, que vous pouvez trouver dans votre profil. Cette clé est différente des clés d'API de canal et d'API d'utilisateur.

chaîne de caractère

Paramètres du corps de la requête

Aucun paramètres du corps de la requête n'est disponible pour cet appel d'API.

Réponse

Succès

Code HTTP status

200 OK

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 et la clé 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

développer tout

Vous pouvez utiliser MATLAB® pour lire votre historique d'alertes des 7 derniers jours. Cet exemple montre comment faire une requête HTTP pour générer l'historique de vos alertes. Notez que vous pouvez écrire le code suivant dans n'importe quel environnement MATLAB, y compris dans MATLAB Analysis et sur le desktop MATLAB.

Définissez la clé d'API des alertes et l'URL de la requête. Votre clé API d'alertes se trouve à Account > My Profile.

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

La demande d'envoi d'alertes nécessite un en-tête de clé d'API. Créez weboptions pour que webread puisse écrire correctement votre requête HTTP. Créez également le corps et l'objet de l'e-mail.

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

Utilisez webread (MATLAB) pour effectuer la demande d'obtention de l'historique.

myHistoryStruct = webread(history_url, options);

La requête Web renvoie une structure. Utilisez struct2table (MATLAB), datetime (MATLAB) et table2timetable (MATLAB) pour réécrire la sortie dans un format plus facile à visualiser.

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

Voir aussi

Fonctions

Rubriques