parent
1a89ed296d
commit
06f85f0652
@ -0,0 +1,61 @@
|
||||
# 密码状态接口文档
|
||||
|
||||
## 获取密码状态
|
||||
|
||||
### 接口描述
|
||||
|
||||
获取当前密码功能的启用状态。
|
||||
|
||||
### 基本信息
|
||||
|
||||
| 属性 | 值 |
|
||||
|------|-----|
|
||||
| 方法名 | `/m9z/password/status` |
|
||||
| 请求方式 | POST (JSON-RPC) |
|
||||
| 是否需要认证 | 否(免白名单) |
|
||||
| 描述 | 查询密码保护功能的当前启用状态 |
|
||||
|
||||
### 请求参数
|
||||
|
||||
无请求参数。
|
||||
|
||||
### 响应参数
|
||||
|
||||
| 字段名 | 类型 | 必填 | 描述 |
|
||||
|--------|------|------|------|
|
||||
| enabled | boolean | 是 | 密码保护功能是否已启用 |
|
||||
|
||||
### 响应示例
|
||||
|
||||
**成功响应:**
|
||||
```json
|
||||
{
|
||||
"jsonrpc": "2.0",
|
||||
"id": 1,
|
||||
"result": {
|
||||
"enabled": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**响应字段说明:**
|
||||
|
||||
| 字段 | 说明 |
|
||||
|------|------|
|
||||
| `enabled: true` | 密码保护已启用,所有需要认证的接口必须先通过密码验证 |
|
||||
| `enabled: false` | 密码保护已禁用,所有接口可直接访问 |
|
||||
|
||||
### 相关接口
|
||||
|
||||
| 接口 | 方法 | 描述 |
|
||||
|------|------|------|
|
||||
| 密码验证 | `/m9z/password/verify` | 验证密码并获取会话 ID |
|
||||
| 修改密码 | `/m9z/password/change` | 修改当前密码 |
|
||||
| 启用密码 | `/m9z/password/enable` | 启用密码保护 |
|
||||
| 禁用密码 | `/m9z/password/disable` | 禁用密码保护 |
|
||||
|
||||
### 备注
|
||||
|
||||
- 该接口无需认证,属于白名单接口
|
||||
- `enabled` 状态值存储在配置文件中,重启服务后会恢复为配置文件中的默认值
|
||||
- 默认密码为 `123456`,盐值为 `m9zTty`
|
||||
Loading…
Reference in new issue