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、"daily"。	整数或字符串
`sum`	（可选）获取这些分钟的总和，有效值：10、15、20、30、60、240、720、1440、"daily"。	整数或字符串
`average`	（可选）获取这些分钟的平均值，有效值：10、15、20、30、60、240、720、1440、"daily"。注意：计算平均值时，`NaN` 值被解释为 `0`。	整数或字符串
`median`	（可选）获取这些分钟的中位数，有效值：10、15、20、30、60、240、720、1440、"daily"。	整数或 `string`

提示

results 参数具有最高优先级。将 results 与参数 min、max、timescale、sum、average 或 median 一起使用可能会导致返回少于 8000 条记录。results 参数决定查询所使用的最大条目数，最多为 8000 个。例如，考虑一个每分钟更新一次的通道。对该通道使用参数 ?results=120&sum=60 的读取请求仅返回两条记录，而不是 120 条。请参阅示例读取两小时的 JSON 格式的条目并计算平均值。