后台管理-工艺包版本

创建工艺包版本

类型

POST

描述

工艺包版本在第一期可以不做，后面有需求在追加。后台有这个拓展能力。

可以先使用查询版本功能，查询出默认版本号为空的版本。使用此版本的 id 创建激活码。

请求地址

{{host}}/admin/bags_version/create

参数说明

示例

{
  "bagId": 13,
  "release": "1.5.8",
  "execute": 2
}

介绍

参数	位置	类型	说明
bagId	Body	Number	工艺包 ID
release	Body	String	工艺包具体版本,如 1.5.8
execute	Body	Number	工艺包版本执行力度，参考上面：如 1 代表 1 大版本，如 2 代表 1.5 这个版本段， 如 3 代表 1.5.8 这个小版本

权限说明

🔒 需要带有 JWT 权限,示例：

Authorization: Bearer {token}

返回值说明

示例

{
  "success": true,
  "msg": "OK"
}

解析

参数	类型	说明
success	Boolean	此次请求是否成功
msg	String	返回的信息

查询工艺包版本

类型

GET

描述

条件查询工艺包版本

请求地址

{{host}}/admin/bags_version/list

参数说明

示例

{{host}}/admin/bags_version/list?page=1&per_page=10&sortby=createdAt&order=desc&id=5&uuid=2474C2E6-859E-4F36-9077-F4C7BE37DDA7&status=1&release=5&bagId=13

介绍

参数	位置	类型	说明
page	Query	String?	当前页，默认 1
per_page	Query	String?	每页数量，默认 10
sortby	Query	String?	排序字段，可选 'id', 'createdAt', 'updatedAt'，默认 'id'
order	Query	String?	升序降序，可选 'asc', 'desc'，默认 'asc'
id	Query	Number?	条件查询： id
uuid	Query	String?	条件查询： uuid
status	Query	Number?	条件查询： 状态，可选 0（未废弃）, 1（已废弃） 默认 0
release	Query	String?	条件查询： 模糊查询，版本号
bagId	Query	Number?	条件查询： 工艺包 id，此参数虽然为可选，但在前端的设计上应该设计为必选，查看某个工艺包的版本信息

权限说明

🔒 需要带有 JWT 权限,示例：

Authorization: Bearer {token}

返回值说明

示例

{
  "success": true,
  "msg": "OK",
  "data": {
    "currentPage": 1,
    "pageSize": 10,
    "totalCount": 2,
    "totalPage": 1,
    "list": [
      {
        "id": 15,
        "uuid": "77190BDE-0197-4FFE-B59A-FAD2E49E26D4",
        "type": null,
        "status": 0,
        "name": null,
        "desc": null,
        "jContent": null,
        "valid": 1,
        "version": 1,
        "createdAt": "2023-09-21T09:40:20.000Z",
        "updatedAt": "2023-09-21T09:40:20.000Z",
        "bagId": 13,
        "release": null,
        "execute": null
      },
      {
        "id": 16,
        "uuid": "68780D39-8720-4948-8A10-4C99CE6F0FF3",
        "type": null,
        "status": 0,
        "name": null,
        "desc": null,
        "jContent": null,
        "valid": 1,
        "version": 1,
        "createdAt": "2023-09-21T10:12:52.000Z",
        "updatedAt": "2023-09-21T10:12:52.000Z",
        "bagId": 13,
        "release": "1.0.0",
        "execute": 1
      }
    ]
  }
}

解析

参数	类型	说明
success	Boolean	此次请求是否成功
msg	String	返回的信息
data	Objcet	数据
data.currentPage	Number	当前页
data.pageSize	Number	每页数据量
data.totalCount	Number	总数
data.totalPage	Number	总页数
data.list	Array	查询列表
data.list[n].id	Number	工艺包版本 id
data.list[n].uuid	String	工艺包版本 uuid
data.list[n].status	Number	工艺包版本 状态
data.list[n].bagId	Number	工艺包版本外键链接的工艺包 id
data.list[n].release	String?	工艺包版本 版本号
data.list[n].execute	String?	工艺包版本 执行力度
data.list[n].[other]	Any	工艺包版本 其他信息

废弃工艺包版本

类型

PATCH

描述

工艺包版本不允许修改和删除，错误的工艺包版本只能废弃处理。前台应该也支持查看已经废弃的工艺包版本。

废弃工艺包版本的同时，此接口会同时废弃掉这些版本创建的所有激活码。

这个接口建议前端做二次确认。

请求地址

{{host}}/admin/bags_version/abandon/uuid/:uuid

参数说明

示例

{{host}}/admin/bags_version/abandon/uuid/68780D39-8720-4948-8A10-4C99CE6F0FF3

介绍

参数	位置	类型	说明
uuid	Param	String	工艺包版本 UUID

权限说明

🔒 需要带有 JWT 权限,示例：

Authorization: Bearer {token}

返回值说明

示例

{
  "success": true,
  "msg": "OK"
}

解析

参数	类型	说明
success	Boolean	此次请求是否成功
msg	String	返回的信息