主要内容

获取警报历史记录

使用HTTP Get获取警报历史

展开全部页面

请求

HTTP方法

得到

URL

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

URL参数

的名字 优先级 描述

数

 可选

要返回的结果数。缺省值为10，最大值为100。

后

 可选 只包含历史记录项requested_at晚一点。格式时间符合ISO 8601。例如，2020-05-15T20:03:48-05:00表示美国东部标准时间2020年5月15日20:03:48。如果您不包括时区偏移量，ThingSpeak将假设指定的时间为UTC时间。注意:警报历史记录项仅保留7天，7天之后它们将不再可用。

之前

 可选 只包含历史记录项requested_at比这个时间更早。格式时间符合ISO 8601。例如，2020-05-15T20:03:48-05:00表示美国东部标准时间2020年5月15日20:03:48。如果您不包括时区偏移量，ThingSpeak将假设指定的时间为UTC时间。注意:警报历史记录项仅保留7天，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 Analysis和桌面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, options);

web请求返回一个结构体。使用struct2table(MATLAB)，datetime(MATLAB),table2timetable(MATLAB)将输出重写为更容易查看的形式。

history = struct2table(myHistoryStruct，“AsArray”,真正的);历史。requestdat = datetime(历史。“InputFormat”，“uuuu-MM-dd 'HH: mm: ss。SSSz”，“时区”，“美国/ New_York”）;历史= table2时间表(历史)
历史= 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}{“植物土壤信息”}{“发送”}

另请参阅

功能

主题