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

Read Settings

Lire les paramètres du canal avec HTTP GET

Requête

Méthode HTTP

GET

URL

https://api.thingspeak.com/channels/<channel_id>.<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 ou xml.

Exemple : https://api.thingspeak.com/channels/266256.json

Paramètres de la chaîne de requête

NomDescriptionType de valeur
api_key

(Obligatoire pour les chaînes privées) Spécifiez la clé API utilisateur, que vous pouvez trouver dans votre profil. Cette clé est différente des clés d'API de canal.

chaîne de caractère

Réponse

Succès

Code HTTP status

200 OK

Body
GET https://api.thingspeak.com/channels/9.json

La réponse est un objet JSON du canal public 9 :

{
  "id": 9,
  "name": "my_house",
  "description": "Netduino Plus connected to sensors around the house",
  "latitude": "40.44",
  "longitude": "-79.9965",
  "created_at": "2010-12-14T01:20:06Z",
  "elevation": "",
  "last_entry_id": 11684395,
  "public_flag': true
  "url": ""
  "ranking": 100,
  "tags": [
    {
      "id": 9,
      "name": "temp"
    },
    {
      "id": 25,
      "name": "light"
    },
    {
      "id": 3,
      "name": "sensor"
    }
  ]
}
GET https://api.thingspeak.com/channels/9.xml

La réponse est un objet XML du canal public 9 :

<?xml version="1.0" encoding="UTF-8"?>
<channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description> Netduino Plus connected to sensors around the house.</description>
    <latitude type="decimal">40.5</latitude>
    <longitude type="decimal">-79.9965</longitude>
    <created-at type="dateTime">2010-12-14T01:20:06Z</created-at>
    <elevation></elevation>
    <last-entry-id type="integer">11684395</last-entry-id>
    <public_flag>true</public_flag>
    <url></url>
    <ranking type="integer">100</ranking>
    <tags type="array">
       <tag>
          <id type="integer">9</id>
          <name>temp</name>
      </tag>
      <tag>
         <id type="integer">25</id>
         <name>light</name>
      </tag>
      <tag>
         <id type="integer">3</id>
         <name>sensor<name>
      </tag>
    </tags>
</channel>

Erreur

Pour la liste complète, voir Codes d'erreur.

Exemples

Afficher les paramètres du canal

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, copiez l'URL suivante dans la barre d'adresse de votre navigateur Web, en remplaçant <channel_ID> par votre ID de canal et <XXXXXXXXXXXXXXXX> par votre clé API utilisateur, qui se trouve dans Account > My Profile.

https://api.thingspeak.com/channels/<channel_ID>.json?api_key=<XXXXXXXXXXXXXXXX>

La réponse est un objet JSON des paramètres du canal , comme indiqué dans la section réponse.

Voir aussi

Fonctions

Rubriques