Contenido principal

Esta página se ha traducido mediante traducción automática. Haga clic aquí para ver la última versión 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

NombreDescripció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

NombreDescripciónTipo 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
GET https://api.thingspeak.com/channels.json?api_key=XXXXXXXXXXXXXXXX

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

[
  {
    "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 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.