API文档: https://open.iot.10086.cn/doc/iot_platform/book/api/introduce.html
一. 新版API调用格式:
https(http)://openapi.heclouds.com/{namespace}?action=xxxx&version=1
其中:
新版API分为设备管理类和应用开发类两大块, 文档如下:
设备管理类https://open.iot.10086.cn/doc/iot_platform/book/api/common/createDevice.html
应用开发类
https://open.iot.10086.cn/doc/iot_platform/book/api/application/queryStatistics.html
二. 新版token计算
新版token计算 参考文档:https://open.iot.10086.cn/doc/iot_platform/book/api/auth.html
下面的是python版本的计算方法, 修改里面的信息,运行一下就能得到新版token
import base64
import hmac
import time
from urllib.parse import quote
def token(userId,access_key):
version = '2020-05-29'
res = 'userid/%s' % userId
# 用户自定义token过期时间
et = str(int(time.time()) + 3600)
# 签名方法，支持md5、sha1、sha256
method = 'sha1'
# 对access_key进行decode
key = base64.b64decode(access_key)
# 计算sign
org = et + '\n' + method + '\n' + res + '\n' + version
sign_b = hmac.new(key=key, msg=org.encode(), digestmod=method)
sign = base64.b64encode(sign_b.digest()).decode()
# value 部分进行url编码，method/res/version值较为简单无需编码
sign = quote(sign, safe='')
res = quote(res, safe='')
# token参数拼接
token = 'version=%s&res=%s&et=%s&method=%s&sign=%s' % (version, res, et, method, sign)
return token
if __name__ == '__main__':
userId = '163120' #这里改成您自己的id
access_key = '0sWvXoPixxdrSDcKDeEHbgvNGPRV5luHWx3HjA1no84ZAYyG9GvlWJmUMaLm5nlExdVZq3ANuII3GM04/PZxxQ=='
#这里改成您自己的access key
print(token(userId,access_key))
while(1):
pass
具体操作是: 新建一个sign.py文件, 把上面的代码粘进去, 把用户id和accesskey替换成你自己的, 然后保存关闭, 再双击运行.
关于用户id和access key 用以下方法找到
此外,
et = str(int(time.time()) + 3600)说明我们的token只在1小时内有效, 调试过程中注意更新token, 或者把有效时间设长一点.
三. 打开postman尝试调用一个API(以查询设备详情为例)
现在打开postman, 我们可以开始调试API了
查询设备详情API:https://open.iot.10086.cn/doc/iot_platform/book/api/common/queryDeviceDetail.html
首先, 这是一个GET请求, 所以,我们应该设置好基地址和get方法
然后,我们应该写入之前算好的token进行设备鉴权
然后, 根据API请求方法设置get的参数.
根据新版API调用格式, action 和 version是必须的
本例中 action是QueryDeviceDetail
然后, 我们就收到了服务器的回复了!!
至此, 第一个API调用完成.
接下来, 我们将熟悉所有设备和应用API