Thinghttp在设备,网站和Web服务中实现通信,而无需在设备级别上实现协议。您在ThingHttp中指定了操作,您可以使用其他offack™应用程序(如TweetControl,TimeControl和React)触发。
创建一个新的ThingHTTP请求。点击应用程序>Thinghttp.,然后单击新事物http.
指定设置。每种请求都不需要所有设置。所有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触发器传递数据. |
解析字符串 | 输入要在响应数据中查找的标签。 |
保存请求。你的ThingHTTP可以点击以后使用应用程序和选择Thinghttp..
使用GET或POST HTTP请求、TweetControl、TimeControl或React触发ThingHTTP。如果包含数据或使用自定义替换键,则使用POST请求。POST、TimeControl或React触发的请求可以将某些变量传递给ThingHTTP。有关更多信息,请参见通过ThingHttp触发器传递数据.例如,如果使用TimeControl触发您的ThingHttp,则可以通过它被触发的时间。此表提供输入和输出参数以及使用HTTP请求触发ThingHttp的示例呼叫。
请注意
每秒触发ThingHTTP超过一次会导致一个HTTP 429状态码。状态代码将继续执行,直到您将速率降低到每秒一个请求以下。
标题 | 触发ThingHTTP的HTTP POST请求 |
---|---|
URL. | https://api.thingspeak.com/apps/thinghttp/send_request. |
HTTP方法 | 帖子 |
HTTP头 | 内容类型:应用程序/ X-WWW-Form-Urlencoded |
数据参数 | api_key=XXXXXXXXXXXXX |
成功响应 | 200 OK. |
错误响应 | 400无效API键 |
示例HTTP呼叫 | POST/apps/thingtweet/1/statuses/update HTTP/1.1 |
笔记 | 你的ThingHTTP API键必须出现在HTTP报头或正文部分,或者它可以同时出现在两个部分。 如果您未将数据传递给ThingHttp,则可以使用Get请求触发ThingHttp: 得到https://api.thingspeak.com/apps/thinghttp/send_request?api_key=XXXXXXXXXXXXXXX . |
Thinghttp返回HTTP请求的结果。
你可以使用替换键将数据发送到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 |
数据参数 | api_key=XXXXXXXXXXXXX |
成功响应 | 200 OK. 和http,json或text,具体取决于您的thinghttp |
错误响应 | 400无效API键 |
示例HTTP呼叫 | POST/apps/thingtweet/1/statuses/update HTTP/1.1 |
笔记 | 您的Thinghttp API键必须出现在HTTP标头或主体部分中,或者它可以出现在两者中。 |
使用替换密钥的POSTMAN请求
您可以使用邮递员尝试使用RESTFUL API进行HTTP请求进行oritepeak。以下显示如何使用邮递员使用替换键测试您的Thinghttp。
选择帖子
并输入请求URL。
选择身体在授权部分。
选择x-www形式 - Urlencoded.
输入API_KEY.
复制你的ThingHTTP API密钥到价值部分。
输入信息
以及价值部分。
你可以使用替换键将数据传递给你的应用程序。下表总结了您可以使用的标准和自定义替换键。如最后一列所示,有些键是特定于特定类型的请求的。
关键 | 描述 | 例子 | 使用 |
---|---|---|---|
% % YOUR_CUSTOM_LABEL % % |
ThingHTTP将这个自定义替换值替换为具有标签“YOUR_CUSTOM_LABEL”的触发器请求中的数据。 | Field1 = %% your_custom_label %% 发布数据: YOUR_CUSTOM_LABEL = 1234 .结果: 字段1=1234 . |
任何要求 |
% % channel_CHANNEL_ID_ |
指定通道和字段的最后一个值。对私有通道的替换请求与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信息。例如,网页 |
|
JSON | |
JSON(JavaScript对象表示法)通常用于格式化Web数据。如果您的请求返回JSON对象,则可以使用适当的点表示法来检索感兴趣的值。景点12397在MathWorks的停车库提供天气信息®纳蒂克。使用请求URL 这是从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”,…}]} |
|