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 chaîne de caractères de la 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 |
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". |
|
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 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
.
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
Erreur
Pour la liste complète, voir Codes d'erreur.
Si vous n'avez pas accès au canal, la réponse est -1.