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

Read Field

Leer datos de un solo campo de canal con HTTP GET

Solicitud

Método HTTP

GET

URL

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

Parámetros de URL

Nombre	Descripción
`<channel_id>`	(Obligatorio) ID de canal para el canal de interés, especificado como un número entero.
`<field_id>`	(Obligatorio) ID de campo para el canal de interés.
`<format>`	(Obligatorio) Formato para la respuesta HTTP, especificado como `json` , `xml` , o `csv`.

Ejemplo: https://api.thingspeak.com/channels/266256/fields/2.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 a recuperar. El número máximo es 8000.	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
`minutes`	(Opcional) Número de períodos de 60 segundos antes de ahora para incluir en la respuesta. El valor predeterminado es 1440.	entero
`start`	(Opcional) Fecha de inicio en formato AAAA-MM-DD%20HH:NN:SS.	fecha y hora
`end`	(Opcional) Fecha de finalización en formato AAAA-MM-DD%20HH:NN:SS.	fecha y hora
`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
`status`	(Opcional) Incluya actualizaciones de estado en el feed configurando "status=true".	`true` o `false`
`metadata`	(Opcional) Incluya metadatos para un canal configurando "metadata=true".	`true` o `false`
`location`	(Opcional) Incluya latitud, longitud y elevación en el feed configurando "ubicación = verdadero".	`true` o `false`
`min`	(Opcional) Valor mínimo para incluir en la respuesta.	`true` o `false`
`max`	(Opcional) Valor máximo para incluir en la respuesta.	decimal
`round`	(Opcional) Redondee a esta cantidad de decimales.	entero
`timescale`	(Opcional) Obtenga el primer valor en esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diario".	entero o cadena
`sum`	(Opcional) Obtenga la suma de esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diariamente".	entero o cadena
`average`	(Opcional) Obtenga el promedio de esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diariamente". Nota: `NaN` Los valores se interpretan como `0` al calcular el promedio.	entero o cadena
`median`	(Opcional) Obtenga la mediana de esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diariamente".	entero o `string`

Consejo

los results El parámetro tiene la prioridad más alta. Usando results con los parámetros min , max , timescale , sum , average , o median puede hacer que se devuelvan menos de 8000 registros. los results El parámetro determina el número máximo de entradas que se utilizarán para una consulta, hasta 8000. Por ejemplo, considere un canal con una actualización por minuto. Una solicitud de lectura a ese canal con los parámetros ?results=120&sum=60 devuelve solo dos registros, y no 120. Ver el ejemplo Lea dos horas de entradas en formato JSON y promedio.

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 10 resultados en formato JSON

El canal 9 contiene información de varios sensores ambientales del hogar. Puede leer datos de los campos individuales 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. Aquí el formato solicitado es 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, que es de hasta 8000.

https://api.thingspeak.com/channels/9/fields/1.json?results=10

Lea el valor medio cada 10 minutos para 100 resultados en formato XML

En este ejemplo, el formato se especifica como XML. El parámetro de resultados se usa para devolver un número específico de entradas, en este caso 10.

https://api.thingspeak.com/channels/9/fields/2.xml?results=100&median=10

Leer un intervalo de fechas de eventos 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. Usa el ampersand & para agregar el segundo parámetro. En este ejemplo, el start y end Los parámetros se utilizan para especificar límites de fecha para los datos solicitados.

https://api.thingspeak.com/channels/9/fields/1.csv?start=2011-11-11%2010:10:10&end=2011-11-11%2011:11:11