接口调用方式
HTTP
方式
接口地址:
{AppID}为您的应用ID(由平台生成)请按准备工作的引导进入控制台,在开发设置页面查看。
http(s)://iot-api.unisoft.cn/{AppID}/{接口列表中的path}/?{其他参数}&sign={sign}&ts={ts}
http(s)://iot-api.unisoft.cn/{AppID}/{接口列表中的path}/?{其他参数}&sign={sign}&ts={ts}
参数 | 名称 | 说明 |
---|---|---|
sign | 签名 |
所有请求物联网控制台接口,均需在url中携带此参数sign={sign} 取值方法:md5(md5(开发者密码) + 上面的ts参数),32位字符串 |
ts | 时间戳 |
所有请求物联网控制台接口,均需在url中携带此参数ts={timestap} 取值方法:请求时间(timezone,东八区),10位数字 |
MQTT
方式
发布主题:
{AppID}为您的应用ID(由平台生成)请按准备工作的引导进入控制台,在开发设置页面查看。
api/{AppID}/{接口列表中的path}
api/{AppID}/{接口列表中的path}
客户端ID | Client ID | 请在控制台查看 |
地址 | Host | iot-mapi.unisoft.cn |
端口 | port | 1883 |
用户名 | Username | 同开发者ID(AppID) |
密码 | Password | 同开发者密码(AppSecret) |
返回信息格式
全局代码(code)
代码 | 提示 | 说明 |
---|---|---|
5001 | miss app id | 请求地址为 https://iot-api.unisoft.cn/{APPID}/,缺少{APPID},请在控制台查看您的appid |
5002 | miss param ts | 请在请求接口中指定ts(时间戳),取值为请求时的时间戳,10位数字 |
5003 | bad ts | 时间戳错误,ts为请求发生时的时间,是一个动态的值,必须为中国时间 |
5004 | miss param sign | 请在请求接口中指定sign(签名),这是一个计算值 |
5005 | please set app secret | 未设置开发者密码,请在控制台的开发设置中进行设置 |
5006 | bad sign | 签名错误,正确签名为 md5(md5(开发者密码) + (url中的ts参数)) |
5007 | bad debug key | 指定了debug参数,但未开启调试模式,或者是debug参数不正确或已过期 |
5008 | ip:*.*.*.* is not in white list | 开启了IP检查,但接口访问IP不在白名单内,请在控制台的开发设置中,将IP加入白名单 |
5009 | too many request | 单个设备访问最高限制1次/秒,请勿超过此限制 |