获取临时密码信息

更新时间:2024-08-19 06:20:52下载pdf

本文介绍获取临时密码信息的 API。

接口描述

获取门锁指定的临时密码信息。

接口地址

GET: /v1.0/devices/{device_id}/door-lock/temp-password/{password_id}

请求参数

参数名类型参数位置是否必填说明
device_idStringuritrue设备 ID
password_idLonguritrue密码编号

返回参数

参数名类型说明
resultJSONObject

result 说明

参数名类型说明
idLong临时密码的编号
nameString临时密码的名称
phaseInteger密码状态
  • Zigbee:
    • 1:待创建
    • 2:正常
    • 3:已冻结
    • 4:已删除
    • 5:创建失败
  • Wi-Fi:
    • 0:已删除
    • 1:待下发
    • 2:已下发
    • 3:待删除
  • 蓝牙:
    • 0:已删除
    • 1:待下发
    • 2:已下发
    • 3:待删除
    • 7:下发失败
effective_timeLong生效时间,10 位时间戳
invalid_timeLong过期时间,10 位时间戳
phoneString手机号码
time_zoneString时区
delivery_statusInteger操作确认状态,Zigbee 时返回
  • 1:配置中
  • 2:配置成功
  • 3:配置失败
  • 4:重复密码
  • 5:密码已满
  • 6:有效期重叠
schedule_listList周期性功能参数列表

schedule_list 说明

参数名类型说明
invalid_timeLong结束时间。分钟形式存放,例如,"07:30"的取值为 7x60+30=450

请求示例

GET: /v1.0/devices/vdevo15345926009****/door-lock/temp-password/xxx

返回示例

{
    "result": {
        "effective_time": 1530841779,
        "phase": 1,
        "time_zone": "Asia/Shanghai",
        "phone": "123547127362",
        "name": "租客A的密码",
        "invalid_time": 1530881779,
        "id": 1001,
        "delivery_status": 1
    },
    "t": 1542626129429,
    "success": true
}

错误码

参考 错误码