Cette page a été traduite par traduction automatique. Cliquez ici pour voir la dernière version 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

Nom	Priorité	Description
`count`	Facultatif	Le nombre de résultats à renvoyer. La valeur par défaut est 10, la valeur maximale est 100.
`after`	Facultatif	Incluez uniquement les éléments de l'historique avec `requested_at` plus tard que 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`	Facultatif	Incluez 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`	Facultatif	N'incluez que les éléments d'historique dont le sujet contient cette valeur, sensible à la casse.
`status`	Facultatif	N'incluez que les éléments d'historique dont le statut contient cette valeur.

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

En-têtes

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

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

Afficher l'historique des alertes à l'aide de MATLAB

Vous pouvez utiliser MATLAB^® pour lire l’historique de vos 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 MATLAB Analysis et MATLAB de bureau.

Définissez la clé d'API des alertes et l'URL de la requête. Votre clé d'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 . Construisez weboptions afin que webread puisse écrire de manière appropriée 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 formulaire 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'}