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
| Nom | Description |
|---|---|
|
| (Obligatoire) ID du canal pour le canal d’intérêt. |
|
| (Obligatoire) ID de champ pour le domaine d'intérêt. |
|
| (Obligatoire) Format de la réponse HTTP, spécifié comme |
Exemple : https://api.thingspeak.com/channels/266256/fields/2/last.json
Paramètres de la 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é 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". |
|
location | (Facultatif) Incluez la latitude, la longitude et l'altitude dans le flux en définissant "location=true". |
|
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 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 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.
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 horaires 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 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/fields/2/last.csv?api_key=E52AWRAV1RSXQQJW&status=true
Réponse
Erreur
Pour la liste complète, voir Codes d'erreur.
Si vous n'avez pas accès au canal, la réponse est -1.
