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

List Your Channels

Listez vos canaux avec HTTP GET

Requête

Méthode HTTP

GET

URL

https://api.thingspeak.com/channels.<format>

Arguments d'entrée

NomDescription

<format>

(Obligatoire) Format de la réponse HTTP, spécifié comme json ou xml.

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

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

NomDescriptionType de valeur
api_key

(Obligatoire) 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

tag

(Facultatif) Spécifiez une balise à rechercher dans vos canaux.

chaîne de caractère

Type de contenu

application/x-www-form-urlencoded

Réponse

Succès

Code HTTP status

200 OK

Body
GET https://api.thingspeak.com/channels.json?api_key=XXXXXXXXXXXXXXXX

La réponse est un objet JSON de vos canaux et comporte la balise license_id, si vous utilisez un compte payant. Par exemple :

[
  {
    "id": 9,
    "name": "my_house",
    "description": "Netduino Plus connected to sensors around the house",
    "latitude": "40.44",
    "longitude": "-79.996",
    "created_at": "2010-12-13T20:20:06-05:00",
    "elevation": "",
    "last_entry_id": 6062691,
    "public_flag": true
    "url": ""
    "ranking" :100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [
        {
          "id": 9,
          "name": "temp"
        },
        {
          "id": 25,
          "name": "light"
        },
        {
          "id": 3,
          "name": "sensor"
        }
     ]
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  },
  {
    "id": 5683,
    "name": "Residential Data Points",
    "description": "Connected Arduino",
    "latitude": "32.664548",
    "longitude": "-73.654972",
    "created_at": "2013-05-15T12:33:57-04:00",
    "elevation": "100",
    "last_entry_id": 731713,
    "public_flag": true
    "url": ""
    "ranking": 100,
    "metadata": "",
    "license_id": 40526371,
    "tags": [],
    "api_keys":
    [
      {
        "api_key": "XXXXXXXXXXXXXXXX",
        "write_flag": true
      }
      {
        "api_key": "YYYYYYYYYYYYYYYY",
        "write_flag": false
      }    
    ]
  }
]
GET https://api.thingspeak.com/channels.xml?api_key=XXXXXXXXXXXXXXXX

La réponse est un objet XML de vos canaux es et comporte la balise license_id, si vous utilisez un compte payant. Par exemple :


<?xml version="1.0" encoding="UTF-8"?>
<channels type="array">
  <channel>
    <id type="integer">9</id>
    <name>my_house</name>
    <description>
    Netduino Plus connected to sensors around the house
    </description>
    <latitude type="decimal">40.44</latitude>
    <longitude type="decimal">-79.996</longitude>
    <created-at type="dateTime">2010-12-13T20:20:06-05:00</created-at>
    <elevation/>
    <last-entry-id type="integer">6062720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</license_id>
    <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>
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
  <channel>
    <id type="integer">5683</id>
    <name>Residential Data Points</name>
    <description>Connected Arduino</description>
    <latitude type="decimal">32.664548</latitude>
    <longitude type="decimal">-73.654972</longitude>
    <created-at type="dateTime">2013-05-15T12:33:57-04:00</created-at>
    <elevation>100</elevation>
    <last-entry-id type="integer">731720</last-entry-id>
    <public-flag type="boolean">true</public-flag>
    <url/>
    <ranking type="integer">100</ranking>
    <metadata/>
    <license_id type="integer">40526371</license_id>
    <tags type="array" />
    <api-keys type="array">
        <api-key>
            <api-key>XXXXXXXXXXXXXXXX</api-key>
            <write-flag type="boolean">true</write-flag>
        </api-key>
        <api-key>
            <api-key>YYYYYYYYYYYYYYYY</api-key>
            <write-flag type="boolean">false</write-flag>
        </api-key>
    </api-keys>
  </channel>
</channels>

Erreur

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

Voir aussi

Fonctions

Rubriques