Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la versión original en inglés.

List Your Channels

Lista tus canales con HTTP GET

Pedido

Método HTTP

GET

URL

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

Argumentos de entrada

Nombre	Descripción
`<format>`	(Obligatorio) Formato para la respuesta HTTP, especificado como `json` o `xml`.

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

Parámetros de cadena de consulta

Nombre	Descripción	Tipo de valor
`api_key`	(Obligatorio) Especifique la clave API de usuario, que puede encontrar en su profile. Esta clave es diferente de las claves API del canal.	cadena
`tag`	(Opcional) Especifique una etiqueta para buscar en sus canales.	cadena

Tipo de contenido

application/x-www-form-urlencoded

Respuesta

Éxito

Código de estado HTTP

200 OK

Cuerpo

Ejemplo JSON

Ejemplo XML

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

La respuesta es un objeto XML de tus canales y tiene la etiqueta license_id , si estás usando una cuenta paga. Por ejemplo:


<?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>

Error

Para obtener la lista completa, consulte Códigos de error.

Consulte también

Funciones

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

Temas

Propiedades del canal