webwrite

向RESTful web服务写入数据

描述

例子

回复= webwrite (urlPostName1, PostValue1,…,PostNameN PostValueN将内容写入指定的web服务url并返回回复.输入参数PostName1, PostValue1,…,PostNameN PostValueN将内容指定为名称-值对。webwrite表单对web服务的HTTP POST请求体中的名称-值对进行编码。web服务定义回复

web服务提供宁静的返回格式化为JSON、XML、图像或文本等互联网媒体类型的数据。

例子

回复= webwrite (url数据的帖子数据指定的web服务url并设置媒体类型数据

输入参数数据将内容指定为格式编码的字符数组。webwrite数据在对web服务的HTTP POST请求的主体中。web服务定义回复

例子

回复= webwrite (___选项属性指定的其他HTTP请求选项weboptions对象选项.您可以将此语法与前面语法的任何输入参数一起使用。

以internet媒体类型(而不是形式编码的字符数组)编写内容(“应用程序/ x-www-form-urlencoded”),指定MediaType的属性选项

要使用HTTP POST请求请求数据并使用函数读取响应,请指定ContentReader的属性选项作为函数的句柄。如果你为一个返回多个输出参数的函数指定句柄,webwrite返回所有输出参数。

例子

全部折叠

将数字写入Worthsepeak服务器上的频道馈送并读取。

要运行此代码,请创建ThingSpeak帐户。调用webwrite使用写API密钥和通道ID从你的ThingSpeak帐户。默认字段名为“field1”

thingSpeakURL = ' http://api.thingspeak.com/ ';thingSpeakWriteURL = [thingSpeakURL 'update'];writeApiKey = '你的写API键”;字段名=“field1”;fieldValue = 42;响应= webwrite(thingspeakwriteurl,'api_key',writeakikey,fieldname,fieldvalue)

如果这个呼叫webwrite是你ThingSpeak频道的第一次更新,回复1

读回你写给频道的数字。ThingSpeak提供了一个不同的URL来获得你的频道的最后一个条目。您的通道ID是URL的一部分。

channelID = num2str (您的频道ID);ithitionspeakreadurl = [thingspeakurl'频道/'connestid'/ fields /'fieldname'/ last'];data = webread (thingSpeakReadURL api_key, writeApiKey)
data = 42

将数字作为形式编码的字符数组写入ThingSpeak服务器上的通道馈送,并读取回来。

要运行此代码,请创建ThingSpeak帐户。调用webwrite使用写API密钥和通道ID从你的ThingSpeak帐户。将Write API Key和数字编码为格式编码的字符数组。默认字段名为“field1”

thingSpeakURL = ' http://api.thingspeak.com/ ';thingSpeakWriteURL = [thingSpeakURL 'update'];writeApiKey = '你的写API键”;数据= 42;data = num2str(数据);writeApiKey data = [' api_key = ', ' field1 =”,数据);响应= webwrite (thingSpeakWriteURL、数据)

如果这个呼叫webwrite是你ThingSpeak频道的第一次更新,回复1

读回你写给频道的数字。ThingSpeak提供了一个不同的URL来获得你的频道的最后一个条目。您的通道ID是URL的一部分。

channelID = num2str (您的频道ID);thingSpeakReadURL = [thingSpeakURL 'channels/' channelID '/fields/field1/last'];data = webread (thingSpeakReadURL api_key, writeApiKey)
data = 42

将数字作为JSON对象写入ThingSpeak服务器上的频道提要,并将响应作为JSON对象读取。

要运行此代码,请创建ThingSpeak帐户。调用webwrite使用写API密钥和通道ID从你的ThingSpeak帐户。创建一个结构,其中字段是您的写API密钥和数字。默认字段名为“field1”.指定媒体类型为“application / json”

thingSpeakURL = ' http://api.thingspeak.com/update.json ';writeApiKey = '你的写API键”;数据= 42;=数据结构(api_key, writeApiKey field1,数据);选择= weboptions (MediaType, application / json);响应= webwrite (thingSpeakURL、数据选项)
响应= channel_id:您的频道IDfield1: 42 field2: [] field3: [] field4: [] field5: [] field6: [] field7: [] field8: [] created_at: '2014-11-14T20:08:14Z' entry_id: 1 status: [] latitude: [] longitude: [] elevation: [] location: []

作为响应webwrite接收一个JSON对象,其中包含你写到你的ThingSpeak频道的数字。webwrite转换JSON对象并将其作为结构返回回复

在ThingSpeak服务器上写一个数字和一个特定的日期。读一下数字和日期。

要运行此代码,请创建ThingSpeak帐户。调用webwrite使用写API密钥和通道ID从你的ThingSpeak帐户。属性指定提要条目的日期datetime对象。

thingSpeakURL = ' http://api.thingspeak.com/ ';thingSpeakWriteURL = [thingSpeakURL 'update'];writeApiKey = '你的写API键”;字段名=“field1”;fieldValue = 42;D = datetime(2015,3,22,8,15,30,'Format','yyyy-MM-dd HH:mm:ss');响应= webwrite (thingSpeakWriteURL api_key, writeApiKey,…字段名,fieldValue created_at ' D)

如果这个呼叫webwrite是你ThingSpeak频道的第一次更新,回复1

读回频道的最后一个条目。ThingSpeak提供了一个不同的URL来获得你的频道的最后一个条目。附加last.json到URL以获取作为JSON对象的数据。您的通道ID是URL的一部分。

channelID = num2str (您的频道ID);thingSpeakReadURL = [thingSpeakURL 'channels/' channelID '/fields/'…字段名' / last.json '];data = webread (thingSpeakReadURL api_key, writeApiKey)
data = created_at: '2015-03-22T08:15:30Z'

表格上的日期created_at中指定的日期D

输入参数

全部折叠

web服务的URL,指定为字符向量或字符串标量。web服务实现RESTful接口。看到宁静的为更多的信息。

Web服务张贴参数,指定为一对或多对名值参数。一个PostName参数必须指定post参数的名称。一个PostValue参数必须是字符向量、字符串标量或数字、逻辑或datetime值,它指定post参数的值。数字、逻辑和datetime值可以在数组中。web服务定义了它作为请求的一部分接受的名称-值对。webwrite在HTTP POST请求体中将名称-值对编码为表单编码的字符数组,并将内容类型设置为应用程序/ x-www-form-urlencoded默认情况下。

当你指定PostValue作为一个datetime对象,则必须指定其格式属性,以便与web服务所需的格式保持一致。如果格式属性包括时区或偏移量,并且datetime对象不被分区webwrite指定“本地”如时区。

当一个PostValue参数在数组中包含多个值时,请指定ArrayFormat财产的weboptions对象对web服务指定的数组进行表单编码。

例子:webwrite(“//www.tianjin-qmedu.com/matlabcentral/fileexchange/”,“词”,‘webwrite’,‘时间’,7)检索在过去7天内上传到文件交换中包含该单词的文件列表webwrite.文件交换web服务定义术语持续时间参数。

将数据发布到Web服务,指定为字符向量,字符串标量或数字,单元格,逻辑或结构MediaType价值json的,或作为文档对象模型MediaType价值'XML'.如果数据是字符串还是向量webwrite发送它没有转换。所有其他类型都基于weboptions。MediaType价值。有关媒体类型的完整列表,请参见互联网媒体类型

例子:webwrite (' //www.tianjin-qmedu.com/matlabcentral/fileexchange/ ', ' = webwrite&duration = 7”)检索在过去7天内上传到文件交换中包含该单词的文件列表webwrite.文件交换web服务定义术语持续时间参数。

其他HTTP请求选项,指定为weboptions对象。看到weboptions对于所有的请求选项weboptions属性。

输出参数

全部折叠

来自web服务的响应,返回为标量、数组、结构或表。

更多关于

全部折叠

宁静的

休息意味着具象状态传输,这是web服务的一种常见架构风格。RESTful接口提供标准的HTTP方法,如GET、PUT、POST或DELETE。

提示

  • 有关RESTful web服务功能不支持的功万博1manbetx能,请参见HTTP接口

  • webwrite功能写道PostName, PostValue输入参数为格式编码的字符数组。如果您还指定选项输入参数,然后是它MediaType属性必须“应用程序/ x-www-form-urlencoded”

  • webwrite不能转换datetime对象转换为JSON,因为JSON没有定义标准日期格式。

  • webwrite总是把PostName, PostValue的值,而不考虑消息体中的参数RequestMethod的属性选项

在R2015A介绍