后台管理-激活码

创建激活码

类型

POST

描述

创建激活码

请求地址

{{host}}/admin/activation/create

参数说明

示例

{
  "bagVersionId": 7,
  "permanent": false,
  "activationTime": 31536000,
  "ceiling": 1,
  "count": 1
}

介绍

参数	位置	类型	说明
bagVersionId	Body	Number	工艺包版本 ID
permanent	Body	Boolean	是否为永久激活
activationTime	Body	Number?	激活的时间段，当非永久激活时此字段必选，单位秒，最大值 3153600000（100 年）
ceiling	Body	Number	每个激活码可以激活的机器数量，最大值 1000 台
count	Body	Number	批量生成激活码的个数，最大值 100 个激活码

权限说明

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

Authorization: Bearer {token}

返回值说明

示例

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

解析

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

查询激活码

类型

GET

描述

条件查询激活码

请求地址

{{host}}/admin/activation/list

参数说明

示例

{{host}}/admin/activation/list?page=1&per_page=10&sortby=createdAt&order=desc&id=5&uuid=6C4E4252-2663-4274-B053-0BD476C1FADF&status=1&bagVersionId=7&code=FQOQ-7KZS-WUNQ-880Q

介绍

参数	位置	类型	说明
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
bagVersionId	Query	Number?	条件查询： 工艺包版本 id，此参数虽然为可选，但在前端的设计上应该设计为必选，查看某个工艺包版本下面的激活码
code	Query	String?	条件查询： 具体的激活码

权限说明

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

Authorization: Bearer {token}

返回值说明

示例

{
  "success": true,
  "msg": "OK",
  "data": {
    "currentPage": 1,
    "pageSize": 10,
    "totalCount": 116,
    "totalPage": 12,
    "list": [
      {
        "id": 5,
        "uuid": "13A3637A-58D2-4DA6-BBB7-1CD6D4E67176",
        "type": null,
        "status": 0,
        "name": null,
        "desc": null,
        "jContent": null,
        "valid": 1,
        "version": 1,
        "createdAt": "2023-09-19T07:30:49.000Z",
        "updatedAt": "2023-09-19T07:30:49.000Z",
        "bagVersionId": 7,
        "code": "METO-YBFX-2TBI-VYPS",
        "permanent": 0,
        "activationTime": "31536000",
        "ceiling": 10,
        "used": 0
      },
      {
        "id": 7,
        "uuid": "31365987-BD74-4712-89CC-4030D04E3E8A",
        "type": null,
        "status": 0,
        "name": null,
        "desc": null,
        "jContent": null,
        "valid": 1,
        "version": 2,
        "createdAt": "2023-09-19T07:30:49.000Z",
        "updatedAt": "2023-09-21T03:41:30.000Z",
        "bagVersionId": 7,
        "code": "BJKE-9MRM-UOTA-5GEV",
        "permanent": 0,
        "activationTime": "31536000",
        "ceiling": 10,
        "used": 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].bagVersionId	Number	激活码外键链接的工艺包版本 id
data.list[n].code	String?	激活码 具体激活码
data.list[n].permanent	Number?	激活码 是否永久激活
data.list[n].activationTime	Number?	激活码 激活时长，单位秒
data.list[n].ceiling	Number?	激活码 每个激活码可以激活的机器数量
data.list[n].used	Number?	激活码 当前激活码已经使用的激活机器数量，当余量用完了则不能继续使用了
data.list[n].[other]	Any	激活码 其他信息

废弃激活码

类型

PATCH

描述

废弃激活码，已经使用此激活码获取的注册码不受影响。废弃之后不可以再次使用此激活码生成注册码

请求地址

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

参数说明

示例

{{host}}/admin/activation/abandon/uuid/1A3F386A-3439-4F9F-8937-D6EE534E5A23

介绍

参数	位置	类型	说明
uuid	Param	String	激活码 UUID

权限说明

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

Authorization: Bearer {token}

返回值说明

示例

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

解析

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