模块说明
equipment 提供生产设备/仪器的列表与详情接口:列表支持 class 筛选与分页;详情返回设备档案。本模块的接口参数经过表单请求对象(FormRequest)校验,非法参数会被直接拦截。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/equipment |
可选 | 设备列表 |
| GET | /api/equipment/show/{id} |
可选 | 设备详情 |
列表
请求参数
| 参数 | 必填 | 校验 | 说明 |
|---|---|---|---|
page |
否 | 正整数 | 页码,默认 1 |
class |
否 | 安全字符 | 分类筛选值 |
pageSize |
否 | 正整数 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "生产设备",
"class": "",
"equipment_list": [ { "id": 1, "name": "...", "image": "...", "...": "" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 14, "page_count": 2 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/equipment/show/2
{
"code": "OK",
"message": "",
"data": {
"title": "设备名",
"equipment": { "id": 2, "name": "...", "content": "<p>……</p>", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
equipment_list、详情键为equipment; - 参数不合法时由 FormRequest 校验直接返回错误(无需自行防御);
- 详情记录不存在返回
404(not_found)。