POST v1/CtrlMachine/SetTempPassWord?num={num}
智能门锁-临时密码管理
请求信息
URI参数
| 字段名称 | 描述 | 类型 | 约束 |
|---|---|---|---|
| num |
中控机机身号 |
string |
必须 |
Body参数
CMTempPassWordSetting2 实体
CMTempPassWordSetting2| 字段名称 | 描述 | 类型 | 约束 |
|---|---|---|---|
| effectMode |
生效时间类型 |
EffectMode |
枚举定义的值 |
| effectDelay |
经过指定秒数后生效 |
integer | |
| actionType |
操作类型 |
ActionType |
枚举定义的值 |
| pwdID |
密码ID |
string | |
| tempPWD |
临时密码(不可重复,如重复不处理) |
string | |
| effectTime |
在指定的时间点生效 (年月日 时分) |
date | |
| effectiveTime |
有效时长(小时 0.5,1,2,3,4 小时) |
decimal number |
范围 [0.5, 4] |
| effectiveNum |
有效次数(1-254) |
integer |
范围 [1, 254] |
| state |
临时密码状态 |
TempPWDState |
必填 枚举定义的值 |
| id |
中控机的设备id |
string |
必填 |
| timeout |
超时的秒数 如果在Timeout秒之后才收到数据则不处理 |
integer |
范围 [1, 30] |
请求格式
application/json, text/json
例子:
{
"effectMode": 0,
"effectDelay": 1,
"actionType": 0,
"pwdID": "sample string 2",
"tempPWD": "sample string 3",
"effectTime": "2025-11-02 10:10:18",
"effectiveTime": 4.1,
"effectiveNum": 5,
"state": 1,
"id": "sample string 6",
"timeout": 7
}
application/x-www-form-urlencoded
例子:
effectMode=0&effectDelay=0&actionType=0&pwdID=密码ID&tempPWD=临时密码(不可重复,如重复不处理)&effectTime=在指定的时间点生效
(年月日 时分)&effectiveTime=0&effectiveNum=0&state=0&id=中控机的设备id&timeout=0
响应信息
返回类型
ApiResultOfBoolean| 字段名称 | 描述 | 类型 | 约束 |
|---|---|---|---|
| code |
错误码 |
ErrorCode |
必填 |
| msg |
相关提示信息 |
string |
必填 |
| data |
业务数据 |
boolean |
必填 |
响应格式
application/json, text/json
例子:
{
"code": 0,
"msg": "sample string 1",
"data": true
}
接口调试
Authorization
AppId
Token
URI
POST
请求header
请求body
响应body