Main Content

本页采用了机器翻译。点击此处可查看英文原文。

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在地图上显示通道位置
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 进行批量更新

    此示例演示如何使用连接到 Wi-Fi® 网络的 Arduino® MKR1000 板或 ESP8266 板来持续收集 Wi-Fi 信号强度并批量更新 ThingSpeak™通道。

  • 使用粒子光子板批量更新 ThingSpeak 通道

    此示例演示如何使用连接到 Wi-Fi® 网络的粒子光子板批量更新 ThingSpeak™通道。您可以使用 Bulk-Write JSON Data API 批量收集数据并将其发送到 ThingSpeak 通道。通过使用批量更新,您可以降低设备的功耗。在此示例中,您每 15 秒收集一次数据,并使用粒子光子板每 2 分钟更新一次通道。由于粒子光子带有实时时钟,因此您可以使用绝对时间戳来进行批量更新消息。

  • 使用 Raspberry Pi 板进行批量更新

    此示例演示如何使用运行 Python 2.7 的 Wi-Fi 连接的 Raspberry Pi 板收集数据。您可以每 15 秒连续收集一次 CPU 温度和 CPU 利用率,并每 2 分钟批量更新 ThingSpeak通道。此示例使用 Bulk-Write JSON Data API 批量收集数据并将其发送到 ThingSpeak 通道。通过使用批量更新,您可以降低设备的功耗。由于 Raspberry Pi 板没有配备实时时钟,因此您可以使用相对时间戳来进行批量更新消息。

  • 时区参考

    将时区参数添加到您的 HTTP请求中。

疑难解答

错误代码

请参阅 ThingSpeak REST API 错误消息和相应 HTTP 状态代码的详细信息。