Main Content

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

Read Last Entry

Lire la dernière entrée du canal avec HTTP GET

Requête

Méthode HTTP

GET

URL

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

Paramètres d'URL

NomDescription

<channel_id>

(Obligatoire) ID du canal pour le canal d’intérêt.

<format>

(Obligatoire) Format de la réponse HTTP, spécifié comme json, xml, csv ou txt.

Exemple : https://api.thingspeak.com/channels/266256/feeds/last.json

Paramètres de chaîne de requête

NomDescriptionType 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

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

status

(Facultatif) Incluez les mises à jour de statut dans le flux en définissant "status=true".

true ou false

location

(Facultatif) Incluez la latitude, la longitude et l'altitude dans le flux en définissant "location=true".

true ou false

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 la dernière entrée et fournir les résultats au format JSON

Le canal 9 contient des informations provenant de plusieurs capteurs d'environnement domestique. 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 du canal 9 au format JSON.

https://api.thingspeak.com/channels/9/feeds/last.json

Lire la dernière entrée, y compris l'emplacement, et fournir les résultats au format XML

Lorsque vous incluez location=true, ThingSpeak renvoie les informations de localisation de la dernière entrée. Les informations d'emplacement d'entrée sont différentes des informations d'emplacement de canal , qui sont définies dans l' onglet Channel Settings. Ajoutez le premier paramètre après un point d'interrogation ?. Cette requête renvoie les résultats au format XML.

https://api.thingspeak.com/channels/9/feeds/last.xml?location=true

Lire la dernière entrée, y compris le statut d'un canal privé, et fournir les résultats 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 démarrer un logiciel supplémentaire pour afficher ce format. La lecture à partir d'un canal privé nécessite la clé API de lecture. Utilisez le paramètre de la chaîne de requête api_key pour spécifier la clé API. Chaque entrée a également un champ d'état. Dans cet exemple, status=true renvoie l'entrée d'état du canal pour le dernier champ ainsi que les données du flux. Ajoutez le deuxième paramètre après l'esperluette &.

https://api.thingspeak.com/channels/9/feeds/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

Réponse

Succès

Code HTTP status

200 OK

Corps

 JSON ou exemple de texte

 Exemple XML

 Exemple CSV

Erreur

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

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