Path: 宝塔面板 API 参考 › 后台任务

`POST /task`

获取面板后台任务队列信息。

## Request body

_Required._

- `opPostTask.request_time` (string, required) — Unix 时间戳；与接口密钥一起生成 request_token。
- `opPostTask.request_token` (string, required) — 按 API 概览中的双重 MD5 签名算法生成。

## Example request

```text
{
  "request_time": "string",
  "request_token": "string"
}
```

## Code samples

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

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

## Responses

### default

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

#### Example

```json
[]
```


## get_task_lists

## get_task_lists / get_task_find

获取面板后台任务队列信息。

- **路由**：`POST /task`
- **action**：`get_task_lists` 或 `get_task_find`

## get_task_lists

获取当前任务队列列表。

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | `get_task_lists` |

返回空数组表示队列为空。

## get_task_find

查询特定任务。

| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| action | 是 | String | `get_task_find` |

## 输出

返回任务队列数组。空数组 `[]` 表示当前离线无任务。

```json
[]
```