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

Nom	Description
`<format>`	(Obligatoire) Format de la réponse HTTP, spécifié comme `json` ou `xml`.

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

Paramètres de chaîne de requête

Nom	Description	Type de valeur
`api_key`	(Obligatoire) Spécifiez la clé API utilisateur, que vous pouvez trouver dans votre profile. 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

Corps

Exemple JSON

Exemple XML

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

La réponse est un objet XML de vos canaux et porte 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

List Your Public Channels | List Channels | Read Settings | Write Settings

Rubriques

Propriétés du canal