Read Field

使用 HTTP GET 从通道的单个字段读取数据

请求

HTTP方法

GET

URL

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

URL 参数

名称	描述
`<channel_id>`	（必需）感兴趣的通道的通道 ID，指定为整数。
`<field_id>`	（必填）感兴趣的通道的字段 ID。
`<format>`	（必需）HTTP 响应的格式，指定为 `json`、`xml` 或 `csv`。

示例： https://api.thingspeak.com/channels/266256/fields/2.json

查询字符串参数

名称	描述	值类型
`api_key`	（私有通道必需）为此特定通道指定读取 API 密钥。读取 API 密钥位于通道视图的 API Keys 选项卡上。	字符串
`results`	（可选）要检索的条目数。最大数量为 8000。	整数
`days`	（可选）要包含在响应中的之前 24 小时周期数。默认值为 1。	整数
`minutes`	（可选）要包含在响应中的之前 60 秒的时间段数。默认值为 1440。	整数
`start`	（可选）开始日期，格式为 YYYY-MM-DD%20HH:NN:SS。	日期时间
`end`	（可选）结束日期，格式为 YYYY-MM-DD%20HH:NN:SS。	日期时间
`timezone`	（可选）来自时区参考的此请求的标识符。	字符串
`offset`	（可选）显示结果的时区偏移量。使用时区参数可以获得更高的准确性。	整数
`status`	（可选）通过设置“status=true”在源中包含状态更新。	`true` 或 `false`
`metadata`	（可选）通过设置“metadata=true”包含通道的元数据。	`true` 或 `false`
`location`	（可选）通过设置“location=true”在源中包含纬度、经度和海拔。	`true` 或 `false`
`min`	（可选）响应中包含的最小值。	`true` 或 `false`
`max`	（可选）响应中包含的最大值。	小数
`round`	（可选）四舍五入到这么多小数位。	整数
`timescale`	（可选）获取这么多分钟内的第一个值，有效值：10、15、20、30、60、240、720、1440、“每日”。	整数或字符串
`sum`	（可选）获取这么多分钟的总和，有效值：10、15、20、30、60、240、720、1440、“每日”。	整数或字符串
`average`	（可选）获取这么多分钟的平均值，有效值：10、15、20、30、60、240、720、1440、“每日”。注意：计算平均值时，`NaN` 值被解释为 `0`。	整数或字符串
`median`	（可选）获取这些分钟的中位数，有效值：10、15、20、30、60、240、720、1440、“每日”。	整数或 `string`

提示

results 参数具有最高优先级。使用 results 和参数 min、max、timescale、sum、average 或 median 可能会导致返回少于 8000 条记录。results 参数确定用于查询的最大条目数，最多 8000。示例，考虑一个每分钟更新一次的通道。使用参数 ?results=120&sum=60 对该通道的读取请求仅返回两条记录，而不是 120。请参阅示例Read Two Hours of Entries in JSON Format and Average.