通道数据控制
API 密钥
当您使用 ThingSpeak™ API 或 MATLAB® 代码读取数据或向通道写入数据时,您需要适当的读取和写入权限。16 位 API 密钥允许您从私有通道读取数据并写入通道。您不需要 API 密钥即可从公共 ThingSpeak通道读取数据。帐户级 API 密钥在 用户帐户和通道 中描述。
写入API密钥
使用写入 API 密钥更新通道。如果您的 Write API 密钥遭到泄露,您可以生成新密钥。如果您使用 MATLAB 分析或 MATLAB 可视化,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
TG 中的通道访问
要将数据从专用通道读取到 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 的限制。请参阅 Frequently Asked Questions 和 How to Buy 了解最新的许可证信息。要在本地更改设置以满足您的应用要求,请从 GitHub 下载源代码。
API缓存
当您通过 XML 或 JSON 传输数据时,可以缓存数据。返回超过 100 个条目的提要会缓存 5 分钟。此限制提高了应用性能。指定“results=100”或更少的最后一次调用或提要不会被缓存,从而能够生成实时应用。