阿里云物联网套件

《阿里云物联网套件》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、阿里云物联网套件服务器端API阿里云物联网套件服务器端API服务器端API当您需要对接自己的业务系统时，您可以使用服务器端API与云端互通。比如通过您的服务器控制您自己的设备等。阿里云提供POPAPI方便您的系统进行对接，同时提供了几种较为普遍的语言对应的SDK，比如JAVA版、PHP版、Python版。更新历史发布时间更新内容说明初始化SDK文档，初始化生成接2016-01-27初始化SDK文档口版本v201601041，新设增备注册接口见RegistDevice；2，新版本开始增加设备注册接口，API版本新2016-07-06产品的appkey统一命名为增v

2、e20160530productKey；3，支持用户自定义设备id调用方式对API接口调用是通过向API的服务端地址发送HTTPGET/POST请求，并按照接口说明在请求中加入相应请求参数来完成的；根据请求的处理情况，系统会返回处理结果。1.请求结构2.公共参数3.返回结果4.签名机制服务地址IotAPI的服务接入地址为：iot.aliyuncs.com1阿里云物联网套件服务器端API通信协议支持通过HTTP或HTTPS通道进行请求通信。为了获得更高的安全性，推荐您使用HTTPS通道发送请求。请求方法支持HTTPGET方法发送请求，这种方式下请求参数需要包含在请

3、求的URL中，如果是get需要对参数进行urlencode。也可以使用POST。请求参数每个请求都需要指定要执行的操作，即Action参数（例如Sub），以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。字符编码请求及返回结果都使用UTF-8字符集进行编码。公共请求参数公共请求参数是指每个接口都需要使用到的请求参数。名称类型是否必须描述返回值的类型，支持FormatString否JSON与XML。默认为XMLAPI版本号，为日期形式：YYYY-MM-VersionString是DD，最新版本为2016-05-30，每个接口可以存在多个版本阿里云颁发

4、给用户的访AccessKeyIdString是问服务所用的密钥ID签名结果串，关于签名SignatureString是的计算方法，请参见签名机制。签名方式，目前支持SignatureMethodString是HMAC-SHA1请求的时间戳。日期格式按照ISO8601标准TimestampString是表示，并需要使用UTC时间。格式为2阿里云物联网套件服务器端APIYYYY-MM-DDThh:mm:ssZ例如，2016-01-04T12:00:00Z（为北京时间2016年1月04日20点0分0秒）签名算法版本，目前版SignatureVersionString是

5、本是1.0唯一随机数，用于防止网络重放攻击。用户在SignatureNonceString是不同请求间要使用不同的随机数值RegionIdString是取值cn-hangzhou示例https://iot.aliyuncs.com/?Format=xml&Version=2016-05-30&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D&SignatureMethod=HMAC-SHA1&SignatureNonce=15215528852396&SignatureVersion=1.0&AccessKeyId=key

6、-test&Timestamp=2012-06-01T12:00:00Z&RegionId=cn-hangzhou公共返回参数用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId给用户。示例XML示例<接口名称+Response>4C467B38-3910-447D-87BC-AC049166F216JSON示

7、例3阿里云物联网套件服务器端API{"RequestId":"4C467B38-3910-447D-87BC-AC049166F216"/*返回结果数据*/}调用API服务后返回数据采用统一格式，返回的HTTP状态码为2xx，代表调用成功；返回4xx或5xx的HTTP状态码代表调用失败。调用成功返回的数据格式主要有XML和JSON两种，外部系统可以在请求时传入参数来制定返回的数据格式，默认为XML格式。本文档中的返回示例为了便于用户查看，做了格式化处理，实际返回结果是没有进行换行、缩进等处理的。成功结果XML示例

8、g="UTF-8"?><