主要内容

得到警报历史

警报历史与HTTP Get

扩展所有的页面

请求

HTTP方法

得到

URL

https://api.thingspeak.com/alerts/history

URL参数

的名字 优先级 描述

数

 可选

返回结果的数量。默认值是10,最大值为100。

后

 可选 只包括历史项目requested_at晚于这个时间。次/ ISO 8601格式。例如,2020 - 05 - 15 - t20:03:48代表5月15日凌晨5时2020年,20:03:48 EST。如果不包括时区偏移,ThingSpeak假设指定在UTC时间。注意:警报历史物品只保留7天,之后,他们不再是可用的。

之前

 可选 只包括历史项目requested_at早于这个时间。次/ ISO 8601格式。例如,2020 - 05 - 15 - t20:03:48代表5月15日凌晨5时2020年,20:03:48 EST。如果不包括时区偏移,ThingSpeak假设指定在UTC时间。注意:警报历史物品只保留7天,之后,他们不再是可用的。

subject_contains

 可选 包含这个值只包括历史项目主题,敏感的情况。

状态

 可选 包含这个值只包括历史项目状态。

例子:https://api.thingspeak.com/alerts/history?count=10

头

的名字 优先级 描述 值类型
ThingSpeak-Alerts-API-Key 要求

指定警报API密匙,你可以找到你配置文件。这个密钥不同于通道API和用户的API密钥。

字符串

体参数

没有可用的身体这个API调用参数。

响应

成功

HTTP状态代码

200好了

错误

您可以使用接受头来控制细节提供错误消息。提供接受标题和关键application / json, application /问题+ json和服务器返回详细的错误消息以及标准的HTTP响应代码。

可能的HTTP错误的完整列表,请参阅错误代码。

例子

全部展开

您可以使用MATLAB®读你的提醒过去7天内的历史。这个例子展示了如何制作一个HTTP请求生成警报历史。注意,您可以编写以下代码在任何MATLAB环境,包括MATLAB分析和MATLAB桌面。

设置警报API键和请求的URL。警报API密钥位于账户>我的资料。

apiKey =“XXXXXXXXXXXXXXXX”;history_url =“https://api.thingspeak.com/alerts/history”

警报发送请求需要一个API密匙头。构建weboptions这webread可以适当的写你的HTTP请求。创建邮件正文和主题。

选择= weboptions (“HeaderFields”,(“ThingSpeak-Alerts-API-Key”apiKey]);

使用webread(MATLAB)使得到历史的要求。

myHistoryStruct = webread (history_url选项);

web请求返回一个结构体。使用struct2table(MATLAB),datetime(MATLAB),table2timetable(MATLAB)改写成一个容易视图形式的输出。

历史= struct2table (myHistoryStruct,“AsArray”,真正的);历史。requestedAt = datetime (history.requestedAt,“InputFormat”,“uuuu-MM-dd 'HH: mm: ss.SSSz”,“时区”,“美国/ New_York”);历史= table2timetable(历史)
历史= 2×3时间表requestedAt sentAt主体地位____________________ ____________________________ __________________________ ________ 18 - 12月- 2019年13:46:48 {' 2019 - 12 - 18 t18:46:54.160z}{“植物土壤信息”}{‘送’}18 - 12月- 2019年13:43:36 {' 2019 - 12 - 18 t18:43:42.032z}{“植物土壤信息”}{“发送”}

另请参阅

功能

主题