创建图
使用 HTTP GET 生成图
请求
HTTP 方法
GET
URL
https://api.thingspeak.com/channels/<channel_id>/charts/<field_id>
URL 参数
| 名称 | 描述 |
|---|---|
| （必填）感兴趣通道的通道 ID。 |
| （必填）感兴趣字段的字段 ID。 |
示例： https://api.thingspeak.com/channels/99990/charts/2
图查询字符串参数
使用这些参数来调整图属性。使用 ? 追加第一个参数，使用 & 追加后续参数。
| 名称 | 描述 | 值类型 |
|---|---|---|
title | （可选）图标题。默认为通道名称。 | 字符串 |
xaxis | （可选）图 x 轴标签。默认值为 "Date"。 | 字符串 |
yaxis | （可选）图 y 轴标签。默认是字段名称。 | 字符串 |
color | （可选）线条颜色的十六进制值。默认值为 FF000（红色）。 | 字符串 |
bgcolor | （可选）背景颜色。默认为白色。 | 字符串 |
type | （可选）图类型。默认是线。 |
|
width | （可选）图宽度（以像素为单位），iframe 宽度大 20 像素，默认图宽度：400。设置为 auto 以根据其父容器自动调整图大小。 | 整数 |
height | （可选）图高度（以像素为单位），iframe 高度大 20 像素，默认图高度：200。设置为 auto 以根据其父容器自动调整图大小。 | 整数 |
dynamic | （可选）根据更新中提到的时间间隔自动更新图。默认值为 false。 |
|
step | （可选）将图绘制为步骤图。默认值为 false。 |
|
yaxismin | （可选）图 Y 轴的最小值。如果为空，则自动计算值。 | 小数 |
yaxismax | （可选）图 Y 轴的最大值。如果为空，则自动计算值。 | 小数 |
update | （可选）自动更新图的时间间隔（以秒为单位）。默认值为 15。 | 整数 |
Feed 查询字符串参数
使用这些参数可以调整用于生成图的通道数据的属性。如果没有前面的参数，则使用 ? 追加第一个参数，使用 & 追加后续参数。否则，将所有参数追加在 & 上。
| 名称 | 描述 | 值类型 |
|---|---|---|
api_key | （私有通道必需）为此特定通道指定读取 API 密钥。读取 API 密钥可在通道视图的 API Keys 选项卡上找到。 | 字符串 |
results | （可选）要检索的条目数。最大数量为 8000。默认值为 100。 | 整数 |
days | （可选）要包含在源中的从现在开始的 24 小时时间段的数量。 | 整数 |
start | （可选）开始日期，格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
end | （可选）结束日期，格式为 YYYY-MM-DD%20HH:NN:SS。 | 日期时间 |
offset | （可选）用于显示结果的时区偏移。使用时区参数可获得更高的准确性。 | 整数 |
min | （可选）响应中包含的最小值。 | 小数 |
max | （可选）响应中包含的最大值。 | 小数 |
round | （可选）四舍五入到小数点后这么多位。 | 整数 |
timescale | （可选）。获取这些分钟内的第一个值。有效值为：10、15、20、30、60、240、720、1440、"daily"。 | integer or string |
sum | （可选）。获得这么多分钟的总和。有效值为：10、15、20、30、60、240、720、1440、"daily"。 | integer or string |
average | （可选）获取这么多分钟的平均值。有效值为 10、15、20、30、60、240、720、1440 和 "daily"。注意：计算平均值时，NaN 值被解释为 0。 | 整数或字符串 |
median | （可选）获取这么多分钟的中位数。有效值为：10、15、20、30、60、240、720、1440，"daily" | integer or string |
示例
您可以使用 Web 浏览器对 ThingSpeak™ RESTful API 完成 GET HTTP 请求。要查看 HTTP 响应的格式，请点击链接或将其复制到您的浏览器。
修改图显示参数
修改图数据
您可以修改用于生成自定义图的数据。使用 average 参数对一定分钟数求平均值，使用 days 选择一定天数的数据（最多 8000 个点），使用 min 显示大于给定最小值的数据。使用此 HTTP GET 创建图：
https://api.thingspeak.com/channels/276330/charts/1?average=240&days=7&min=200
响应是一个图，显示四天 240 分钟窗口内的平均土壤湿度值，不包括任何值低于 200 的点。该数据来自发布到 ThingSpeak 通道 276330 的土壤湿度监测器。由于数据是动态的，因此这里的示例将与您所看到的不同。
