Contenu principal

Cette page a été traduite par traduction automatique. Cliquez ici pour voir la version originale 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 la 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é API de lecture se trouve dans l'onglet API Keys de la vue du canal.

chaîne de caractère

timezone

(Facultatif) Identifiant de 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 vers 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 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 de 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

Body

 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.