Path: API › 数据库管理

`POST /database`

获取数据库备份文件列表。

## Request body

_Required._

- `action53.request_time` (string, required) — Unix 时间戳。
- `action53.request_token` (string, required) — 按 API 概览生成的签名。
- `action53.action` (string, required) — 具体操作名称。
  - one of `"GetBackup"`
- `action53.p` (integer, optional) — 页码
- `action53.limit` (integer, optional) — 每页数量

## Example request

```text
{
  "request_time": "string",
  "request_token": "string",
  "action": "GetBackup",
  "p": 0,
  "limit": 0
}
```

## Code samples

### cURL（填写面板地址与签名）

```curl
curl --request POST \
  --url "https://your-panel.example.com:8888/database" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "request_time=<Unix时间戳>" \
  --data-urlencode "request_token=<按 API 概览生成的签名>" \
  --data-urlencode "action=GetBackup"
```

## Responses

### default

接口响应，业务状态见下方详细说明。

#### Example

```json
{
  "status": true,
  "msg": "OK",
  "data": [
    {
      "name": "bt_db_2026-05.sql.zip",
      "path": "/www/backup/database/...",
      "size": "1.5 KB",
      "addtime": "2026-05-22 09:04:41"
    }
  ],
  "page": "<div>分页信息</div>"
}
```

- `action53.response.default.status` (boolean, optional) — 请求结果
- `action53.response.default.data` (array<unknown>, optional) — 备份文件列表
- `action53.response.default.data[].name` (string, optional) — 备份文件名
- `action53.response.default.data[].path` (string, optional) — 备份文件路径
- `action53.response.default.data[].size` (string, optional) — 文件大小
- `action53.response.default.data[].addtime` (string, optional) — 备份时间
- `action53.response.default.page` (string, optional) — 分页 HTML


## GetBackup

## GetBackup / GetAllBackup

获取数据库备份文件列表。

- **路由**：`POST /database`
- **action**：`GetBackup` 或 `GetAllBackup`

## 输入参数

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | `GetBackup` 或 `GetAllBackup` |
| p | 否 | Integer | 页码 |
| limit | 否 | Integer | 每页数量 |

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| status | Boolean | 请求结果 |
| data | Array | 备份文件列表 |
| data[].name | String | 备份文件名 |
| data[].path | String | 备份文件路径 |
| data[].size | String | 文件大小 |
| data[].addtime | String | 备份时间 |
| page | String | 分页 HTML |

## 示例

```json
{
    "status": true, "msg": "OK",
    "data": [{"name": "bt_db_2026-05.sql.zip", "path": "/www/backup/database/...", "size": "1.5 KB", "addtime": "2026-05-22 09:04:41"}],
    "page": "<div>分页信息</div>"
}
```