Path: API › 计划任务

`POST /crontab`

根据类型获取网站或数据库列表，用于计划任务中选择操作对象。

## Request body

_Required._

- `action12.request_time` (string, required) — Unix 时间戳。
- `action12.request_token` (string, required) — 按 API 概览生成的签名。
- `action12.action` (string, required) — 具体操作名称。
  - one of `"GetDataList"`
- `action12.type` (string, required) — `"sites"` 网站 / `"databases"` 数据库

## Example request

```text
{
  "request_time": "string",
  "request_token": "string",
  "action": "GetDataList",
  "type": "string"
}
```

## Code samples

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

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

## Responses

### default

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

#### Example

```json
{
  "data": [
    {
      "name": "testapi.bt.local",
      "ps": "API测试备注"
    }
  ],
  "orderOpt": []
}
```

- `action12.response.default.data` (array<unknown>, optional) — 数据列表
- `action12.response.default.orderOpt` (array<unknown>, optional) — 排序选项


## GetDataList

根据类型获取网站或数据库列表，用于计划任务中选择操作对象。

- **路由**：`POST /crontab`
- **action**：`GetDataList`

## 输入参数

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | 固定值 `GetDataList` |
| type | 是 | String | `"sites"` 网站 / `"databases"` 数据库 |

## 输出参数

| 参数名称 | 类型 | 描述 |
|----------|------|------|
| data | Array | 数据列表 |
| orderOpt | Array | 排序选项 |

## 示例

```json
{"data": [{"name": "testapi.bt.local", "ps": "API测试备注"}], "orderOpt": []}
```