REST API

使用 REST API 调用创建和更新 ThingSpeak™ 通道和图

表述性状态转移 (REST) 是一种架构风格，设计为通过 HTTP 进行通信的请求-响应模型。物联网平台 ThingSpeak 使用 REST API 调用 GET、POST、PUT 和 DELETE 来创建和删除通道、读取和写入通道数据以及清除通道中的数据。Web 浏览器或客户端向服务器发送请求，服务器以请求的格式返回数据。Web 浏览器使用此接口来检索网页或将数据发送到远程服务器。

您还可以使用基于数据采取行动的 REST API 调用来与社交媒体、Web 服务和设备进行交互。

REST API 参考

全部展开

读取数据

`Read Data`	使用 HTTP GET 读取通道中所有字段的数据
`Read Field`	使用 HTTP GET 从通道的单个字段读取数据
`Read Status`	使用 HTTP GET 读取通道状态字段
`Read Last Entry`	使用 HTTP GET 读取通道中的最后一条条目
`Read Last Field Entry`	使用 HTTP GET 读取通道字段中的最后一条条目
`Read Last Status`	使用 HTTP GET 读取通道的最新状态

写入数据

`Write Data`	使用 HTTP GET 或 POST 更新通道数据
`Bulk Write JSON Data`	使用单个 HTTP POST 以 JSON 格式将多个条目写入通道
`Bulk Write CSV Data`	使用单个 HTTP POST 以 CSV 格式将多个条目写入通道

写入图像

`Write Image`	使用 HTTP POST 写入通道图像
`Delete Image`	使用 HTTP DELETE 从通道中删除图像
`Read Status of Image Request`	使用 HTTP GET 读取图像请求的状态

查看通道和通道设置

`List Your Public Channels`	使用 HTTP GET 列出用户名的通道
`List Your Channels`	使用 HTTP GET 列出您的通道
`List Channels`	使用 HTTP GET 列出公共通道
`Read Settings`	使用 HTTP GET 读取通道设置
`Write Settings`	使用 HTTP PUT 更新通道设置

创建和删除

`Create Channel`	使用 HTTP POST 创建新通道
`Clear Channel`	使用 HTTP DELETE 清除通道中的所有数据
`Delete Channel`	使用 HTTP DELETE 删除通道

读取条目时间

`Read Last Entry Age`	使用 HTTP GET 读取自上次进入通道以来的秒数
`Read Last Field Entry Age`	使用 HTTP GET 读取字段中自上次输入以来的秒数

图

Create Chart 使用 HTTP GET 生成图表

地图

Show Channel Map 在地图上显示通道位置

TalkBack

`Add Command`	将 TalkBack 命令添加到 TalkBack 队列
`Get Command`	从 TalkBack 队列获取 TalkBack 命令
`Get All Commands`	从 TalkBack 队列获取所有 TalkBack 命令
`Get Last Command`	从 TalkBack 队列获取最后执行的 TalkBack 命令
`Update Command`	更新 TalkBack 队列中的命令
`Execute Command`	执行 TalkBack 队列中的下一个 TalkBack 命令
`Write Data and Execute TalkBack Command`	使用 HTTP GET 或 POST 更新通道数据并执行 TalkBack 命令
`Delete Command`	从 TalkBack 队列中删除 TalkBack 命令
`Delete All Commands`	删除 TalkBack 队列中的所有 TalkBack 命令

警报

`Send Alert`	使用 HTTP POST 创建电子邮件警报
`Get Alert History`	使用 HTTP GET 获取警报历史记录

主题

在 REST API 和 MQTT API 之间进行选择
了解何时使用 REST 和 MQTT 来更新通道。
使用 Arduino 或 ESP8266 进行批量更新
此示例展示如何使用 Arduino® MKR1000 开发板或 ESP8266 开发板连接到 Wi-Fi® 网络，以持续收集 Wi-Fi 信号强度并批量更新 ThingSpeak™ 通道。
使用粒子光子板批量更新 ThingSpeak 通道
此示例展示如何使用连接到 Wi-Fi® 网络的粒子光子板批量更新 ThingSpeak™ 通道。您可以使用 Bulk-Write JSON Data API 批量收集数据并发送到 ThingSpeak 通道。通过使用批量更新，您可以减少设备的功耗。在此示例中，您使用粒子光子板每 15 秒收集一次数据，每 2 分钟更新一次通道。由于 Particle Photon 带有实时时钟，因此您可以使用绝对时间戳来发送批量更新消息。
使用 Raspberry Pi 开发板进行批量更新
此示例展示如何使用运行 Python 2.7 的连接 Wi-Fi 的 Raspberry Pi 板收集数据。您可以每 15 秒连续收集一次 CPU 温度和 CPU 利用率，并每 2 分钟批量更新一次 ThingSpeak 通道。本示例使用 Bulk-Write JSON Data API 批量收集数据并将其发送到 ThingSpeak 通道。通过使用批量更新，您可以减少设备的功耗。由于 Raspberry Pi 开发板没有配备实时时钟，因此您可以使用相对时间戳来批量更新消息。
时区参考
向您的 HTTP 请求添加时区参数。