通道数据控制
API 密钥
当您使用 ThingSpeak™ API 或 MATLAB® 代码向您的通道读取或写入数据时,您需要适当的读写权限。16 位 API 密钥允许您从私有通道读取并写入通道。您不需要 API 密钥即可从公共 ThingSpeak 通道读取。账户级别 API 密钥在 用户帐户和通道 中描述。
写入 API 密钥
使用写入 API 密钥来更新通道。如果您的写入 API 密钥被泄露,您可以生成一个新密钥。如果您使用 MATLAB Analysis 或 MATLAB Visualization,API 信息将显示在右侧的帮助窗格中。
要查找您的写入 API 密钥:
点击 Channels > My Channels。
选择要更新的通道。
选择 API Keys 选项卡。
读取 API 密钥
读取 API 密钥使您的应用程序能够从 API 读取数据。您可以为不同的应用程序生成多个读取 API 密钥。
要获取读取 API 密钥:
点击 Channels > My Channels。
选择要更新的通道。
选择 API Keys 选项卡。
点击 Generate New Read API Key。
API 端点
HTTP API 地址
要使用 HTTPS 与 ThingSpeak 进行安全通信,请使用以下地址:
https://api.thingspeak.com
支持非安全通信,但强烈不建议。如果有必要,使用以下地址进行 HTTP 通信:
http://api.thingspeak.com
MQTT API 地址
要与端口 8883
(安全)或端口 1883
(非安全)上的 ThingSpeak MQTT 代理进行通信,请使用以下地址:
mqtt3.thingspeak.com
MATLAB 中的通道访问
要将数据从私有通道读取到 MATLAB,请使用 thingSpeakRead
函数:
thingSpeakRead(channelID,'ReadKey','Your.Read.API.Key.String');
要从 MATLAB 写入数据,请使用 thingSpeakWrite
函数:
thingSpeakWrite(channelId,data,'WriteKey','Your.Write.API.Key.String');
API 速率限制
免费许可证用户可以每 15 秒更新一次 ThingSpeak 通道,付费用户可以每 1 秒更新一次。更频繁地更新会导致错误。对于任何用户来说,读取请求之间的时间不受 ThingSpeak 的限制。请参阅常见问题和如何购买,了解最新的许可信息。要更改设置以满足本地应用程序要求,请从 GitHub 下载源代码。
API 缓存
您可以在通过 XML 或 JSON 传输数据时缓存数据。返回超过 100 个条目的提要将被缓存 5 分钟。此限制提高了应用程序的性能。指定 "results=100" 或更少的最后一次调用或馈送不会被缓存,从而可以生产实时应用程序。