Path: 宝塔面板 API 参考 › Proxy 反向代理

`POST /mod/proxy/com/get_list/stype`

获取所有 `project_type` 为 `proxy` 的站点列表，支持分页和搜索。

## Request body

_Required._

- `opPostModProxyComGetListStype.request_time` (string, required) — Unix 时间戳；与接口密钥一起生成 request_token。
- `opPostModProxyComGetListStype.request_token` (string, required) — 按 API 概览中的双重 MD5 签名算法生成。
- `opPostModProxyComGetListStype.p` (integer, optional) — 页码，默认 1
- `opPostModProxyComGetListStype.limit` (integer, optional) — 每页数量，默认 10
- `opPostModProxyComGetListStype.search` (string, optional) — 搜索关键词，按站点名称模糊匹配

## Example request

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

## Code samples

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

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

## Responses

### default

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

#### Example

```json
{
  "code": 0,
  "status": true,
  "msg": "OK",
  "data": {
    "where": "project_type=?",
    "page": "<div>分页HTML</div>",
    "data": [
      {
        "id": 24,
        "name": "test-proxy-api.local",
        "path": "/www/wwwroot/test-proxy-api.local",
        "status": "1",
        "ps": "备注",
        "addtime": "2026-05-23 10:08:57",
        "edate": "0000-00-00",
        "rname": ""
      }
    ]
  }
}
```

- `opPostModProxyComGetListStype.response.default.data` (array<unknown>, optional) — 站点列表，每项包含 id, name, path, status, ps, addtime, edate, rname
- `opPostModProxyComGetListStype.response.default.data[].healthy` (integer, optional) — 健康状态：1 正常，0 异常
- `opPostModProxyComGetListStype.response.default.data[].ssl` (object, optional) — SSL 证书信息，未开启时为 -1
- `opPostModProxyComGetListStype.response.default.data[].proxy_pass` (string, optional) — 代理目标地址
- `opPostModProxyComGetListStype.response.default.data[].waf` (object, optional) — WAF 状态
- `opPostModProxyComGetListStype.response.default.page` (object, optional) — 分页信息


## get_list

获取所有 `project_type` 为 `proxy` 的站点列表，支持分页和搜索。

- **路由**：`POST /mod/proxy/com/get_list/stype`
- **action**：`get_list`

## 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|----------|------|------|------|
| p | 否 | int | 页码，默认 1 |
| limit | 否 | int | 每页数量，默认 10 |
| search | 否 | string | 搜索关键词，按站点名称模糊匹配 |

## 输出参数
| 参数名称 | 类型 | 描述 |
|----------|------|------|
| data | list | 站点列表，每项包含 id, name, path, status, ps, addtime, edate, rname |
| data[].healthy | int | 健康状态：1 正常，0 异常 |
| data[].ssl | object | SSL 证书信息，未开启时为 -1 |
| data[].proxy_pass | string | 代理目标地址 |
| data[].waf | object | WAF 状态 |
| page | object | 分页信息 |

## 示例

### 请求
```bash
curl -X POST "http://192.168.168.213:8888/mod/proxy/com/get_list/stype" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "p=1&limit=10&request_time=...&request_token=..."
```

### 响应
```json
{
  "code": 0,
  "status": true,
  "msg": "OK",
  "data": {
    "where": "project_type=?",
    "page": "<div>分页HTML</div>",
    "data": [
      {
        "id": 24,
        "name": "test-proxy-api.local",
        "path": "/www/wwwroot/test-proxy-api.local",
        "status": "1",
        "ps": "备注",
        "addtime": "2026-05-23 10:08:57",
        "edate": "0000-00-00",
        "rname": ""
      }
    ]
  }
}
```