Read Data
Leer datos de todos los campos en el canal con HTTP GET
Pedido
Método HTTP
GET
URL
https://api.thingspeak.com/channels/
<channel_id>
/feeds.<format>
Parámetros de URL
Nombre | Descripción |
---|---|
| (Obligatorio) ID de canal para el canal de interés. |
| (Obligatorio) Formato para la respuesta HTTP, especificado como |
Ejemplo: https://api.thingspeak.com/channels/266256/feeds.json
Parámetros de cadena de consulta
Nombre | Descripción | Tipo de valor |
---|---|---|
api_key | (Requerido para canales privados). Especifique Leer clave API para este canal específico. La clave de API de lectura se encuentra en la pestaña API Keys de la vista del canal. | cadena |
results | (Opcional) Número de entradas para recuperar. El número máximo es 8.000. | 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 |
minutes | (Opcional) Número de períodos de 60 segundos anteriores a ahora para incluirlos 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) Desplazamiento de la zona horaria en la que se muestran los resultados. Utilice el parámetro de zona horaria para mayor precisión. | entero |
status | (Opcional) Incluya actualizaciones de estado en el feed configurando "status=true". |
|
metadata | (Opcional) Incluya metadatos para un canal configurando "metadata=true". |
|
location | (Opcional) Incluya latitud, longitud y elevación en el feed configurando "ubicación=verdadero". |
|
min | (Opcional) Valor mínimo para incluir en la respuesta. | decimal |
max | (Opcional) Valor máximo para incluir en la respuesta. | decimal |
round | (Opcional) Redondea 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, "diario". | entero o cadena |
average | (Opcional) Obtenga el promedio de esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diario". Nota: Los valores | entero o cadena |
median | (Opcional) Obtenga la mediana de esta cantidad de minutos, valores válidos: 10, 15, 20, 30, 60, 240, 720, 1440, "diario". |
|
Consejo
El parámetro results
tiene la prioridad más alta. Usando results
con los parámetros min
, max
, timescale
, sum
, average
o median
pueden provocar que se devuelvan menos de 8000 registros. El parámetro results
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 sólo dos registros, y no 120. Ver el ejemplo Read Two Hours of Entries in JSON Format and Average.
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.
Leer tres entradas en formato JSON
El canal 9 contiene información de varios sensores del entorno doméstico. 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. 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 hasta 8000.
Lea dos horas de entradas en formato JSON y en promedio
El canal 9 contiene información de varios sensores del entorno del hogar y se actualiza una vez por minuto. 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. 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. En esta solicitud, se promedian 120 resultados en dos respuestas.
https://api.thingspeak.com/channels/9/feeds.json?results=120&average=60
Lea cuatro entradas 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 ?
.
Lea cinco entradas de un canal privado en formato JSON
Para leer datos de un canal privado, proporcione la clave de API de lectura con el parámetro api_key
. Agregue el primer parámetro después de un signo de interrogación ?
. Agregue el segundo parámetro después del signo comercial &
. En este caso, results
se utiliza para solicitar cinco resultados.
https://api.thingspeak.com/channels/9/feeds.json?api_key=E52AWRAV1RSXQQJW&results=5
Leer un rango de fechas de eventos 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 iniciar software adicional para mostrar este formato. En este ejemplo, los parámetros start
y end
se utilizan para especificar límites de fecha para los datos solicitados.
Respuesta
Error
Para obtener la lista completa, consulte Códigos de error.
Si no tienes acceso al canal, la respuesta es -1.