模块说明
certificate 提供资质证书/荣誉的列表与详情接口:列表支持 class 筛选与分页;当站点维护了证书分类时返回 class_list 筛选选项;详情返回证书档案(含证书图片等)。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/certificate |
可选 | 证书列表 |
| GET | /api/certificate/show/{id} |
可选 | 证书详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 分类筛选值 |
page |
否 | 页码,默认 1 |
pageSize |
否 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "资质证书",
"certificate_list": [ { "id": 1, "name": "...", "image": "...", "...": "" } ],
"class_list": [ { "name": "全部", "value": "" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 8, "page_count": 1 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
class_list仅在站点维护了证书分类时返回,否则为空数组。
详情
GET /api/certificate/show/3
{
"code": "OK",
"message": "",
"data": {
"title": "证书名",
"certificate": { "id": 3, "name": "...", "image": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
certificate_list、详情键为certificate; - 详情 ID 无效返回
422,记录不存在返回404。