set-first-over 接口
首次访问设备时,需要调用该接口进行初始化设置,主要是设置 设备名称 、 配对密码 和 时区时间。
通过 get-status 接口可以获取到以下信息:
{
"cur-status": 65552 // 设备运行状态掩码
...
}
设备首次运行的值为:statusFirst(0x01),如果 cur-status & statusFirst = statusFirst,那么说明设备是首次运行
请求方式
// 启用配对密码
GET http://ip/usapi?method=set-first-over&name=xxx&enable-passwd=1&passwd=xxx&timezone=Asia/Shanghai&is-auto=1&time=
// 禁用配对密码
GET http://ip/usapi?method=set-first-over&name=xxx&enable-passwd=0&timezone=xxx&is-auto=1&time=2019-09-10+15:00:00
参数 | 说明 |
---|---|
method | 方法名称:set-first-over |
name | 设备名称,字符要求: 1、1 - 32 个字符 2、由 A-Z, a-z, 0-9, 空格 ._-+'[]() 组成,并且不能以空格开头或结束 |
enable-passwd | 配对密码启用状态 0:禁用 1:启用 |
passwd | 密码,MD5 加密,enable-passwd = 1 时必填 |
time | 密码,MD5 加密,enable-passwd = 1 时必填 |
passwd | 密码,MD5 加密,enable-passwd = 1 时必填 |
timezone | 时区,如:Asia/Shanghai,具体值请参考set-date-time.md |
is-auto | 是否自动获取时间,0:手动设置,1:根据时区自动获取 |
time | 手动设置时间,字符串类型,格式如:2019-09-10 15:10:00 当 is-auto=1 时,time="" 即可 |
返回数据
{
"result": 0
}
属性 | 说明 |
---|---|
result | 返回状态,0:操作成功,返回其它值请参考 API 状态码 |