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

Read Status

Lire le champ d'état du canal avec HTTP GET

Requête

Méthode HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>/status.<format>

Paramètres d'URL

Nom	Description
<channel_id>	(Obligatoire) ID du canal pour le canal d’intérêt.
<format>	(Facultatif) Format de la réponse HTTP, spécifié comme json, xml ou csv.

Exemple : https://api.thingspeak.com/channels/266256/status.json

Paramètres de chaîne de requête

Nom	Description	Type de valeur
api_key	(Obligatoire pour les canaux privés) Spécifiez la clé d'API en lecture pour ce canal spécifique. La clé d'API Lire se trouve dans l'onglet API Keys de la vue des canaux.	chaîne de caractère
results	(Facultatif) Nombre d'entrées à récupérer, 8000 max.	entier
days	(Facultatif) Nombre de périodes de 24 heures avant maintenant à inclure dans la réponse. La valeur par défaut est 1.	entier
timezone	(Facultatif) Identifiant du Référence des fuseaux horaires pour cette demande.	chaîne de caractère
offset	(Facultatif) Décalage du fuseau horaire dans lequel les résultats sont affichés. Utilisez le paramètre de fuseau horaire pour une plus grande précision.	entier

Conseil

Le paramètre results détermine le nombre maximum d'entrées à récupérer pour une requête, jusqu'à 8000. La durée par défaut est limitée à 1 jour (24 heures). Pour obtenir des résultats sur plus d'un jour et limiter les entrées, utilisez ensemble les paramètres results et days.

Réponse

Succès

Code HTTP Status

200 OK

Si vous n'avez pas accès au canal, la réponse est -1.

Corps

 Exemple JSON

GET https://api.thingspeak.com/channels/1417/status.json?results=2 or GET https://api.thingspeak.com/channels/1417/status?results=2

Réponse The response is a JSON object of the channel statuses, for example:{ "channel": { "name": "CheerLights", "latitude": "40.5", "longitude": "-80.22" }, "feeds": [ { "created_at": "2014-02-26T02:28:01Z", "entry_id": 11888, "status": "@cheerlights green" }, { "created_at": "2014-02-26T22:05:31Z", "entry_id" :11889, "status": "@cheerlights blue" } ] }

 Exemple XML

GET https://api.thingspeak.com/channels/1417/status.xml?results=2

Réponse The response is a XML object of the channel statuses, for example: <?xml version="1.0" encoding="UTF-8"?> <channel> <name>CheerLights</name> <latitude type="decimal">40.5</latitude> <longitude type="decimal">-80.22</longitude> <feeds type="array"> <feed> <created-at type="dateTime">2014-02-26T02:28:01Z</created-at> <entry-id type="integer">11888</entry-id> <status>@cheerlights green</status> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2014-02-26T22:05:31Z</created-at> <entry-id type="integer">11889</entry-id> <status>@cheerlights blue</status> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 Exemple CSV

GET https://api.thingspeak.com/channels/276330/status.csv?results=2

Réponse The response is a CSV object of the channel statuses, for example: created_at,entry_id,status 2017-10-16 15:15:12 UTC,3385,Soil is Wet. 2017-10-16 15:15:13 UTC,3386,Water needed soon!

Erreur

Pour la liste complète, voir Codes d'erreur.

Si vous n'avez pas accès au canal, la réponse est -1.

Exemples

Vous pouvez utiliser votre navigateur Web pour effectuer des requêtes HTTP GET auprès de l'API RESTful pour ThingSpeak™. Pour voir le format d'une réponse HTTP, cliquez sur le lien ou copiez-le dans votre navigateur.

Lire trois résultats d'état au format JSON

Le canal 276330 stocke les informations sur l'humidité du sol pour une usine de bureau. Vous pouvez lire les données de ce canal public . Le format de la réponse apparaît à la fin de l'URL, avant tout paramètre de la chaîne de requête. Cet exemple renvoie la dernière entrée d'état du canal 276330 au format JSON. Ajoutez le premier paramètre après un point d'interrogation ?. Vous pouvez utiliser le paramètre de résultats pour contrôler le nombre d'entrées renvoyées, jusqu'à 8 000.

https://api.thingspeak.com/channels/276330/status.json?results=3

Lire quatre résultats d'état au format XML

Dans cet exemple, le format est spécifié comme XML. Le paramètre de résultats est utilisé pour renvoyer un nombre défini d'entrées, dans ce cas quatre. Le premier paramètre est ajouté après un point d'interrogation ?.

https://api.thingspeak.com/channels/276330/status.xml?results=4

Lire cinq résultats d'état à partir d'un canal privé au format CSV

Lorsque vous demandez la sortie au format csv, le fichier renvoyé est un format de variable séparée par des virgules. Selon la configuration de votre ordinateur, votre navigateur peut ouvrir un logiciel supplémentaire pour afficher ce format. Pour lire les données d'un canal privé, fournissez la clé d'API en lecture après le paramètre api_key. Ajoutez le premier paramètre après un point d'interrogation ?. Utilisez une esperluette & pour ajouter le deuxième paramètre. Dans ce cas, le paramètre results est utilisé pour renvoyer cinq résultats.

https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5

Voir aussi

Fonctions

• Read Data | Read Field | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

Rubriques

• Capteur d'humidité utilisant les requêtes HTTP POST au canal