Main Content

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

Read Last Field Entry

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

Requête

Méthode HTTP

GET

URL

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

Paramètres d'URL

NomDescription

<channel_id>

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

<field_id>

(Obligatoire) ID de champ pour le domaine 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/fields/2/last.json

Paramètres de chaîne de caractères de la 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

prepend

(Facultatif) Texte à ajouter avant la réponse de l'API.

chaîne de caractère
append

(Facultatif) Texte à ajouter après la réponse de l'API.

chaîne de caractère

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 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/fields/2/last.json

Lire la dernière entrée, y compris l'emplacement au format XML

Lorsque vous incluez le paramètre offset, ThingSpeak renvoie les données temporelles avec le décalage spécifié par rapport à GMT. 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/fields/2/last.xml?offset=3

Lire la dernière entrée, y compris le statut 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 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/fields/2/last.csv?api_key=E52AWRAV1RSXQQJW&status=true

Réponse

Succès

Code HTTP status

200 OK

Corps

 Exemple de texte

 Exemple JSON

 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.