---
title: 临时密码管理
summary: 门锁临时密码管理，支持自定义、限时、动态、单次、清空等密码类型及对应 API。
---

## 临时密码管理

临时密码支持： 自定义密码、限时密码、动态密码、单次密码、清空密码。其中自定义密码为在线密码，需要与设备进行交互才能将密码数据同步到设备；其他的密码类型则为离线密码。

### 自定义密码

- 需要设置密码、生效时间、名称（可选），密码在生效时间期间可使用；
- 如超过生效时间，密码将失效；
- 自定义密码可删除，删除后，将失效；
- 自定义密码可冻结或解冻，如进行了冻结操作，则将无法密码开锁。

### 限时密码

- 限时密码在生成后，必须在 24 小时内使用一次；
- 生成后 24 小时内未使用，即使密码未过期，也会变为无效；
- 生成后 24 小时内使用过，当密码时效性过期时，密码状态变为无效；
- 在生效时间中，限时密码可多次被使用。

### 单次密码

- 单次密码在获取后，有效期为6小时，并且在失效前，最多只能使用一次。

### 动态密码

- 动态密码在生成后，有效期为5分钟，失效前可使用多次

### 清空密码

- 用于清空限时密码，在生成密码时，可指定清空所有限时密码或单个密码；
- 清空密码有效期为 24 小时，需要有失效前使用。

### API

#### 创建自定义密码

- 含义：创建自定义的临时密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/createTempCustom)

#### 生成清除密码

- 含义：生成可用于清除限时密码的密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/createTempClear)

#### 生成动态密码

- 含义：用于生成动态密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/createTempDynamic)

#### 生成限时密码

- 含义：用于生成限时密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/createTempLimit)

#### 生成单次密码

- 含义：用于生成单次密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/createTempOnce)

#### 获取有效的临时密码

- 含义：获取有效的自定义、限时、单次、清空等类型密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/getTempEffectiveList)

#### 获取无效的临时密码

- 含义：获取无效的自定义、限时、单次、清空等类型密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/getTempInvalidList)

#### 删除自定义密码

- 含义：删除生效状态的自定义密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/removeTempCustom)

#### 重命名名称

- 含义：重命名自定义、限时、单次、清空等密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/renameTemp)

#### 冻结自定义密码

- 含义：冻结生效状态的自定义密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/freezeTemp)

#### 解冻自定义密码

- 含义：解冻冻结状态的自定义密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/unfreezeTemp)

#### 更新自义定密码

- 含义：更新自定义密码的名称和时效配置
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/updateTempCustom)

#### 清空所有无效密码

- 含义：清空所有无效密码
- 详细：[查看文档](/cn/miniapp/develop/ray/api/doorlock/temporary/clearTempInvalidList)