---
name: "getTempOnlineUnlimitedList"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "getTempOnlineUnlimitedList - 获取在线不限次数密码列表，适用于 WiFi 拍照锁设备。"
summary: "获取在线不限次数密码列表，适用于 WiFi 拍照锁设备。"
---

## getTempOnlineUnlimitedList

> [VERSION] @ray-js/lock-sdk >= 1.0.0

> 💡 此 API 为 WiFi Pro 锁专用，其他锁请勿使用。

### 描述

获取在线不限次数密码列表

### 参数

无


### 返回值

类型: `Promise<OnlinePasswordItem[]>`

在线不限次数密码列表

##### OnlinePasswordItem

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `status` | `"effective" \| "synchronizing" \| "expired" \| "disabled" \| "invalid"` | 状态：effective 生效中、synchronizing 同步中、expired 已过期、disabled 已禁用、invalid 已失效 |
| `effectiveConfig` | `EffectiveConfig` | 时效配置 |
| `unlockBindingId` | `string` | 密码 ID |
| `failReason` | `number` | 失败原因 |
| `name` | `string` | 密码名称 |
| `phase` | `number` |  |
| `opModeType` | `number` | 密码类型 |
| `opModeSubType` | `number` | 密码子类型 |
| `sn` | `number` | 密码序号 |
| `opModeInfo` | `Object` | 清空码信息 |

##### OnlinePasswordItem.opModeInfo 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `hasClearPwd` | `boolean` | 否 | - | 是否为清空码 |
| `revokedPwdName` | `string` | 否 | - | 需要清空的密码名称 |
| `revokedPwdEffectiveTime` | `number` | 否 | - | 需要清空的密码生效时间 |
| `revokedPwdInvalidTime` | `number` | 否 | - | 需要清空的密码失效时间 |


### 引用对象

##### `interface` EffectiveConfig

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `effectiveDate` | `number` | 生效日（秒级时间戳） |
| `expiredDate` | `number` | 失效日（秒级时间戳） |
| `repeat` | `"none" \| "week"` | 重复策略：无或按周 |
| `weeks` | `[0 \| 1, 0 \| 1, 0 \| 1, 0 \| 1, 0 \| 1, 0 \| 1, 0 \| 1]` | 周重复位图 |
| `effectiveTime` | `number` | 每日生效开始时间，单位：分钟 |
| `expiredTime` | `number` | 每日失效结束时间，单位：分钟 |

##### `type` Week

周重复位图：下标 0–6 对应周日–周六，0 不生效 1 生效

```typescript
export type Week = [
  BitStatus,
  BitStatus,
  BitStatus,
  BitStatus,
  BitStatus,
  BitStatus,
  BitStatus,
];
```

##### `type` BitStatus

位开关：0 关、1 开 / Single-bit flag

```typescript
export type BitStatus = 0 | 1;
```


### 示例代码

#### 示例

```ts
import { getTempOnlineUnlimitedList } from '@ray-js/lock-sdk';
const list = getTempOnlineUnlimitedList();
```