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

Solicitud

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 la clave API de lectura para este canal específico. La clave API de lectura se encuentra en el API Keys pestaña 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 antes de 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) Compensación de la zona horaria en la que se muestran los resultados. Utilice el parámetro de zona horaria para una mayor precisión.	entero

Consejo

los results El parámetro determina el número máximo de entradas que se recuperarán para una consulta, hasta 8000. El intervalo 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 tanto el results y days parámetros juntos.

Respuesta

Éxito

Código de estado HTTP

200 OK

Si no tiene 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 tiene acceso al canal, la respuesta es -1.

Ejemplos

Puede usar 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.

Leer tres resultados de estado en formato JSON

El canal 276330 almacena información sobre la humedad del suelo para una planta de oficina. Puede 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 JSON formato. 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

Leer 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

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

Cuando solicita la salida en csv formato, el archivo devuelto es un formato 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 API de lectura después del parámetro api_key. Agregue el primer parámetro después de un signo de interrogación ?. Usar un ampersand & para agregar el segundo parámetro. En este caso, el results El parámetro 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 mediante solicitudes HTTP POST al canal