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

Read Status

Leer el campo de estado del canal con HTTP GET

Pedido

Método HTTP

GET

URL

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

Parámetros de URL

Nombre	Descripción
<channel_id>	(Obligatorio) ID de canal para el canal de interés.
<format>	(Opcional) Formato para la respuesta HTTP, especificado como json, xml o csv.

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

Parámetros de cadena de consulta

Nombre	Descripción	Tipo de valor
api_key	(Obligatorio para canales privados) Especifique Leer clave API para este canal específico. La clave Leer API se encuentra en la pestaña API Keys de la vista del canal.	cadena
results	(Opcional) Número de entradas para recuperar, 8000 máx.	entero
days	(Opcional) Número de períodos de 24 horas anteriores a ahora para incluir en la respuesta. El valor predeterminado es 1.	entero
timezone	(Opcional) Identificador de Referencia de zonas horarias para esta solicitud.	cadena
offset	(Opcional) Desplazamiento de la zona horaria en el que se muestran los resultados. Utilice el parámetro de zona horaria para mayor precisión.	entero

Consejo

El parámetro results determina el número máximo de entradas que se recuperarán para una consulta, hasta 8000. El período de tiempo predeterminado está limitado a 1 día (24 horas). Para obtener resultados de más de 1 día y limitar las entradas, utilice los parámetros results y days juntos.

Respuesta

Éxito

Código de estado HTTP

200 OK

Si no tienes acceso al canal, la respuesta es -1.

Cuerpo

 Ejemplo JSON

GET https://api.thingspeak.com/channels/1417/status.json?results=2 or GET https://api.thingspeak.com/channels/1417/status?results=2

Respuesta The response is a JSON object of the channel statuses, for example:{ "channel": { "name": "CheerLights", "latitude": "40.5", "longitude": "-80.22" }, "feeds": [ { "created_at": "2014-02-26T02:28:01Z", "entry_id": 11888, "status": "@cheerlights green" }, { "created_at": "2014-02-26T22:05:31Z", "entry_id" :11889, "status": "@cheerlights blue" } ] }

 Ejemplo XML

GET https://api.thingspeak.com/channels/1417/status.xml?results=2

Respuesta The response is a XML object of the channel statuses, for example: <?xml version="1.0" encoding="UTF-8"?> <channel> <name>CheerLights</name> <latitude type="decimal">40.5</latitude> <longitude type="decimal">-80.22</longitude> <feeds type="array"> <feed> <created-at type="dateTime">2014-02-26T02:28:01Z</created-at> <entry-id type="integer">11888</entry-id> <status>@cheerlights green</status> <id type="integer" nil="true"/> </feed> <feed> <created-at type="dateTime">2014-02-26T22:05:31Z</created-at> <entry-id type="integer">11889</entry-id> <status>@cheerlights blue</status> <id type="integer" nil="true"/> </feed> </feeds> </channel>

 Ejemplo CSV

GET https://api.thingspeak.com/channels/276330/status.csv?results=2

Respuesta The response is a CSV object of the channel statuses, for example: created_at,entry_id,status 2017-10-16 15:15:12 UTC,3385,Soil is Wet. 2017-10-16 15:15:13 UTC,3386,Water needed soon!

Error

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

Si no tienes acceso al canal, la respuesta es -1.

Ejemplos

Puede utilizar su navegador web para completar solicitudes GET HTTP a la API RESTful para ThingSpeak™. Para ver el formato de una respuesta HTTP, haga clic en el enlace o cópielo en su navegador.

Lea tres resultados de estado en formato JSON

El canal 276330 almacena información sobre la humedad del suelo para una planta de oficina. Puedes leer datos de este canal público. El formato de la respuesta aparece al final de la URL, antes de cualquier parámetro de cadena de consulta. Este ejemplo devuelve la última entrada de estado del canal 276330 en formato JSON . Agregue el primer parámetro después de un signo de interrogación ?. Puede utilizar el parámetro de resultados para controlar el número de entradas devueltas, hasta 8000.

https://api.thingspeak.com/channels/276330/status.json?results=3

Lea cuatro resultados de estado en formato XML

En este ejemplo, el formato se especifica como XML. El parámetro de resultados se utiliza para devolver un número determinado de entradas, en este caso cuatro. El primer parámetro se añade después de un signo de interrogación ?.

https://api.thingspeak.com/channels/276330/status.xml?results=4

Lea cinco resultados de estado de un canal privado en formato CSV

Cuando solicita la salida en formato csv , el archivo devuelto tiene un formato de variable separado por comas. Dependiendo de la configuración de su computadora, su navegador puede abrir software adicional para mostrar este formato. Para leer datos de un canal privado, proporcione la clave de API de lectura después del parámetro api_key. Agregue el primer parámetro después de un signo de interrogación ?. Utilice un signo comercial & para agregar el segundo parámetro. En este caso, el parámetro results se utiliza para devolver cinco resultados.

https://api.thingspeak.com/channels/276330/status.csv?api_key=E52AWRAV1RSXQQJW&results=5

Consulte también

Funciones

• Read Data | Read Field | Write Data | Bulk Write JSON Data | Bulk Write CSV Data

Temas

• Sensor de humedad que utiliza solicitudes HTTP POST para canalizar