加载中…
生产设备 equipment

模块说明

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)。
添加日期:2026-10-06