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
Nom | Description |
---|---|
| (Obligatoire) ID du canal pour le canal d’intérêt. |
| (Obligatoire) Format de la réponse HTTP, spécifié comme |
Exemple : https://api.thingspeak.com/channels/266256/feeds/last.json
Paramètres de 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é 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". |
|
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
.
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
Erreur
Pour la liste complète, voir Codes d'erreur.
Si vous n'avez pas accès au canal, la réponse est -1.