主要内容

Thinghttp应用程序

Thinghttp在设备,网站和Web服务中实现通信,而无需在设备级别上实现协议。您在ThingHttp中指定了操作,您可以使用其他offack™应用程序(如TweetControl,TimeControl和React)触发。

创建ThingHttp请求

  1. 创建一个新的ThingHTTP请求。点击应用程序>Thinghttp.,然后单击新事物http

  2. 指定设置。每种请求都不需要所有设置。所有ThingHTTP请求都需要以下参数。

    所需的参数 描述
    的名字 输入ThingHTTP请求的唯一名称。
    API密匙 自动生成的API键用于ThingHttp请求。
    URL. 输入您正在从中从中请求数据的网站或Web服务的地址https://.(注意http://支持,金宝app但强烈劝阻。)
    方法

    选择访问URL所需的以下HTTP方法之一:GET、POST、PUT或DELETE。

    HTTP版本 除非您的服务器以其他方式指定1.1,否则请指定1.1。

    根据请求的性质,可以指定其他参数。例如,对需要身份验证的服务器的ThingHTTP请求需要用户名和密码。

    可选参数 描述
    http auth用户名 如果您的URL需要认证,请输入用户名进行认证,以便访问私有通道或网站。
    HTTP身份验证密码 如果您的URL需要认证,请输入认证密码,以便访问私有渠道或网站。
    内容类型 输入请求内容的MIME或表单类型。例如,应用程序/x-www-form-urlencoded
    主办 如果您的Thinghttp请求需要主机地址,请输入域名。例如,api.thingspeak.com
    标题 如果您的Thinghttp请求需要自定义标头,请输入标题的名称和值。例如,指定使用的字节范围范围:BYTES = 500-999
    身体

    输入要包含在您的请求中的邮件。


    你也可以在body部分使用替换键来包含要发送到ThingHTTP应用的数据。例如,请参见通过ThingHttp触发器传递数据

    解析字符串

    输入要在响应数据中查找的标签。
    可以使用惟一ID或XPATH解析HTML中的特定数据。如果返回的数据是一个JSON对象,您可以使用JSON点表示法来解析特定值的响应数据。看到解析字符串想要查询更多的信息。

  3. 保存请求。你的ThingHTTP可以点击以后使用应用程序和选择Thinghttp.

触发Thinghttp.

使用GET或POST HTTP请求、TweetControl、TimeControl或React触发ThingHTTP。如果包含数据或使用自定义替换键,则使用POST请求。POST、TimeControl或React触发的请求可以将某些变量传递给ThingHTTP。有关更多信息,请参见通过ThingHttp触发器传递数据.例如,如果使用TimeControl触发您的ThingHttp,则可以通过它被触发的时间。此表提供输入和输出参数以及使用HTTP请求触发ThingHttp的示例呼叫。

请注意

每秒触发ThingHTTP超过一次会导致一个HTTP 429状态码。状态代码将继续执行,直到您将速率降低到每秒一个请求以下。

使用HTTP请求触发ThingHTTP

标题 触发ThingHTTP的HTTP POST请求
URL. https://api.thingspeak.com/apps/thinghttp/send_request.
HTTP方法 帖子
HTTP头 内容类型:应用程序/ X-WWW-Form-Urlencoded
x-ithitionspeakapikey = xxxxxxxxxxxxxxx

数据参数 api_key=XXXXXXXXXXXXX
成功响应 200 OK.
和http,json或text,具体取决于thinghttp
错误响应 400无效API键
0最低等待时间未达到
-1请求失败
示例HTTP呼叫 POST/apps/thingtweet/1/statuses/update HTTP/1.1
主持人:api.thingspeak.com
内容类型:应用程序/ X-WWW-Form-Urlencoded
cache - control: no - cache

api_key=XXXXXXXXXXXXX
笔记 你的ThingHTTP API键必须出现在HTTP报头或正文部分,或者它可以同时出现在两个部分。
如果您未将数据传递给ThingHttp,则可以使用Get请求触发ThingHttp:
得到https://api.thingspeak.com/apps/thinghttp/send_request?api_key=XXXXXXXXXXXXXXX

Thinghttp返回HTTP请求的结果。

通过ThingHttp触发器传递数据

你可以使用替换键将数据发送到ThingHTTP,包括2%符号以内的键。你可以在ThingHTTP的任何可用部分包含一个替换密钥。例如,你可以在ThingHTTP主体中包含一个标签,并使用POST来触发你的ThingHTTP请求来传递数据。这个例子展示了如何使用ThingHTTP请求来发布消息到ThingSpeak频道。创建你的ThingHTTP,并在主体中使用自定义替换键%%message%%。

当您在帖子中包含触发您的ThingHTTP的消息时,HTTP帖子将触发您的ThingHTTP,将%%message%%替换为“1234”,并更新ThingSpeak上的频道。ThingHTTP的主体参数与HTTP触发器请求的主体参数不同。HTTP触发器请求参数如下表所示。

标题 触发ThingHTTP的HTTP POST请求
URL. https://api.thingspeak.com/apps/thinghttp/send_request.
HTTP方法 帖子
HTTP头 内容类型:应用程序/ X-WWW-Form-Urlencoded
X-THINGSPEAKAPIKEY = XXXXXXXXXXXXXXX

数据参数 api_key=XXXXXXXXXXXXX
消息= 1234.

成功响应 200 OK.
和http,json或text,具体取决于您的thinghttp
错误响应 400无效API键
0最低等待时间未达到
-1请求失败
示例HTTP呼叫 POST/apps/thingtweet/1/statuses/update HTTP/1.1
主持人:api.thingspeak.com
内容类型:应用程序/ X-WWW-Form-Urlencoded
cache - control: no - cache

api_key = xxxxxxxxxxxxxxx&message = 1234
笔记 您的Thinghttp API键必须出现在HTTP标头或主体部分中,或者它可以出现在两者中。

使用替换密钥的POSTMAN请求

您可以使用邮递员尝试使用RESTFUL API进行HTTP请求进行oritepeak。以下显示如何使用邮递员使用替换键测试您的Thinghttp。

  1. 选择帖子并输入请求URL。

  2. 选择身体在授权部分。

  3. 选择x-www形式 - Urlencoded

  4. 输入API_KEY.复制你的ThingHTTP API密钥到价值部分。

  5. 输入信息以及价值部分。

更换键

你可以使用替换键将数据传递给你的应用程序。下表总结了您可以使用的标准和自定义替换键。如最后一列所示,有些键是特定于特定类型的请求的。

关键 描述 例子 使用
% % YOUR_CUSTOM_LABEL % % ThingHTTP将这个自定义替换值替换为具有标签“YOUR_CUSTOM_LABEL”的触发器请求中的数据。 Field1 = %% your_custom_label %%
发布数据:YOUR_CUSTOM_LABEL = 1234
结果:字段1=1234
任何要求
% % channel_CHANNEL_ID_
field_FIELD_NUMBER % %
指定通道和字段的最后一个值。对私有通道的替换请求与ThingHTTP请求返回空值。 最新的值是% % channel_12_field_1% %
结果:最新的值是2.5
任何要求
%%约会时间%% TimeControl或React运行时的完整日期和时间。 事件发生的日期和时间为%%约会时间%%
结果:事件发生的日期和时间为2014-09-24下午5:32
TimeControl或反应
% % % % TimeControl ran时的工作日的名称。 事件发生的那一天是% % % %”
结果:事件发生的那一天是星期三
时刻
%% day_index %% 周日开始的工作日的零基索引。 这个星期使用的天数是%% day_index %%
结果:这个星期使用的天数是3.
时刻
% % % % TimeControl跑的那一天的小时。 事件发生的小时是% % % %
结果:事件发生的小时是5
时刻
% % % % 时刻的时间分钟。 事件发生的那一刻% % % %
结果:事件发生的那一刻30.
时刻
%%扳机%% 触发React的值。 这里太热了%%扳机%%C
结果:这里太热了40C
反应
% % channel_id % % 触发反应的通道ID。 推文的频道是% % channel_id % %
结果:推文的频道是1256
反应

解析字符串

ThingHttp发送由请求生成的完整的HTTP响应,它可以是网页,文本或JSON对象。要从响应中提取单个数据元素,请指定解析字符串在你的ThingHTTP请求中。ThingHTTP可以使用唯一的标签ID或XPATH数据解析数据。可以通过解析JSON对象来检索对象的组件。

XPath

您可以使用XML路径语言(XPath)在web页面上指定特定的值。指定网页上某个项的XPath,以便解析该特定项。有些浏览器在单击源视图中的数据时提供XPATH信息。例如,网页www.localconditions.com/massachusetts/01750为Natick提供月亮阶段,在XPath中MA
// * [@ id =“包装器”] / div [3] / div / div [2] / div [1] / div [1] / div / div [2] / div [2] / p [5]/文本()

JSON

JSON(JavaScript对象表示法)通常用于格式化Web数据。如果您的请求返回JSON对象,则可以使用适当的点表示法来检索感兴趣的值。景点12397在MathWorks的停车库提供天气信息®纳蒂克。使用请求URLhttps://api.thingspeak.com/channels/12397/feeds.json?results=1返回JSON对象,类似于此处显示的对象。使用解析字符串饲料[0] .field2检索最新值风速,在这种情况下,返回的值为5.0。

这是从Mathworks Thingseak气象站频道返回的气象站JSON对象的样本。

{"channel": {"id": 12397, "name": "WeatherStation", "description": "MathWorks WeatherStation,…",…“field1”:“风向……,“field2”:“风速(英里)”,…},“提要”:{“created_at”:“2017 - 03 - 13 t14:33:21z”、“entry_id”:1272044,“field1”:“21”、“field2”:“5.0”,…}]}

另请参阅

功能

外部网站