## 面板证书 (`panel-cert`)

仅管理员。面板自己用的 HTTPS 证书状态;一键用面板域名自动申请 Let's Encrypt 证书,续签随证书管理。

鉴权: 仅管理员 · 文档: https://www-demo.kuxitong.com/zh/docs/api/panel-cert

### GET `/api/v2/panel-cert`

查看面板证书状态 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/panel-cert" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/panel-cert/issue`

一键申请面板证书 · 鉴权: 仅管理员

```sh
curl -X POST "https://panel.example.com/api/v2/panel-cert/issue" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

面板证书对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `acme` | CertAcme |  | 自动签发状态(状态、验证方式、续签与最近一次失败原因)。 |
| `cert` | Cert |  | 证书(响应带证书链、域名、到期时间与状态,不带私钥;私钥只能经导出接口取回)。 |
| `cert_id` | integer |  | panel.tls.cert_id;0 = 没配面板证书。 |
| `domain` | string |  | 面板域名(panel.access.domain);空 = 没填。 |
| `https` | string |  | 面板 HTTPS 的现状。on = 面板证书可用且主控开了 HTTPS 监听;no_domain = 没填面板域名(不申请证书);no_cert = 填了域名但没有可用的面板证书;issuing = 证书正在签发;failed = 证书签发失败(原因见 acme.last_error,自动申请的会按间隔重试);no_listen = 证书已有,但主控配置文件没开 HTTPS 监听(listen_tls);expired = 面板证书已过期(not_after 已过,续签没成功)。 可选值: ["on","no_domain","no_cert","issuing","failed","no_listen","expired"] |