1. 版本管理

版本管理

1.1. 添加设备版本信息

基础信息

路径: /v1/api/version/add

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
version string 是 设备版本号,
packageType string 是 安装包类型1-rom 2-apk 3-固件
uri string 是 上传版本地址
packageSize number 否 上传文件包大小
md5Sum string 否 安装包md5值
releaseNote string 否 版本说明
releaseTime integer 否 发版时间
deviceModels array 是 设备兼容型号
  |─ integer

Body示例:

{
    "version": "MegEcy-1.3.5'",
    "packageType": 2,
    "uri": "Z3NwOi8vd3Vrb25n-31ed52a99819bd0020a3fc74de72fcf1.zip",
    "packageSize": 111119,
    "md5Sum": "6dd186dcce291aa6d4e1a268a6e60617",
    "deviceModels": [12, 13]
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─uuid string 否 唯一uuid

响应示例:

{
    "code":0,
    "data":{
        "uuid": "PK-6ca04c71f96844f78eb8"
    },
    "msg":"成功"
}

1.2. 更新设备版本信息

基础信息

路径: /v1/api/version/update

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 版本唯一uuid
releaseNote string 否 版本说明
deviceModels array 否 设备兼容型号信息
  |─ integer
releaseTime integer 否 版本时间

Body示例:

{
    "uuid": "PK-6ca04c71f96844f78eb8",
    "releaseNote": "说明23",
    "deviceModels": [
        49
    ],
    "releaseTime": 1681443170126
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.3. 更新升级包uri

基础信息

路径: /v1/api/version/updateUri

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 升级包uuid
uri string 是 升级包uri
md5Sum string 是 升级包文件md5
packageSize integer 是 升级包大小，单位byte

Body示例:

{
    "uuid": "PK-6ca04c71f96844f78eb8",
    "uri": "Z3NwOi8vd3Vrb25n-31ed52a99819bd0020a3fc74de72fcf1.zip",
    "md5Sum": "6dd186dcce291aa6d4e1a268a6e60617",
    "packageSize": 11221122
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.4. 删除设备版本信息

基础信息

路径: /v1/api/version/delete

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 版本uuid

Body示例:

{
    "uuid": "PK-6ca04c71f96844f78eb8"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

1.5. 分页获取设备版本信息列表

基础信息

路径: /v1/api/version/list

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
packageType integer 否 安装包类型1-rom 2-apk 3-固件
version string 否 安装包版本号,支持模糊查询
deviceModel integer 否 设备型号
pageNum integer 否 1 页码，从1开始
当前页码,不传默认1
pageSize integer 否 20 页面大小
分页大小，不传默认20

Body示例:

{
    "pageNum": 1,
    "pageSize": 10,
    "packageType": 1,
    "deviceModel": 49
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─pageNum integer 是 页码，从1开始
当前页码
  |─pageSize integer 是 页面大小
分页大小
  |─total integer 是 总记录数
总数
  |─list array 否
    |─ object
      |─uuid string 否 对应版本uuid
      |─version string 否 版本号
      |─releaseTime integer 否 版本时间
      |─packageType integer 否 安装包类型1-rom 2-apk 3-固件
      |─packageSize number 否 文件包大小
      |─releaseNote string 否 版本说明
      |─deviceModels array 否 设备型号
        |─ integer
      |─enable string 否 状态：0-禁用，1-启用
      |─uri string 否 上传版本地址
      |─md5Sum string 否 安装包md5值

响应示例:

{
    "code":0,
    "data":{
        "list":[
            {
                "deviceModels":[
                    49
                ],
                "enable":"1",
                "md5Sum":"6dd186dcce291aa6d4e1a268a6e60617",
                "packageSize":1.3519028E7,
                "packageType":1,
                "releaseNote":"sdsd",
                "releaseTime":1678685734000,
                "uri":"Z3NwOi8vd3Vrb25n-31ed52a99819bd0020a3fc74de72fcf1.zip",
                "uuid":"PK-6ca04c71f96844f78eb8",
                "version":"T9.9"
            }
        ],
        "pageNum":1,
        "pageSize":10,
        "total":1
    },
    "msg":"成功"
}

1.6. 获取设备版本信息详情

基础信息

路径: /v1/api/version/detail

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
uuid string 是 版本唯一uuid

Body示例:

{
    "uuid": "PK-e0e0f5e4c6204fb5aeec"
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值
  |─uuid string 否 对应版本uuid
  |─version string 否 版本号
  |─releaseTime integer 否 版本时间
  |─packageType integer 否 安装包类型1-rom 2-apk 3-固件
  |─packageSize number 否 文件包大小
  |─releaseNote string 否 版本说明
  |─deviceModels array 否 设备型号
    |─ integer
  |─enable string 否 状态：0-禁用，1-启用
  |─uri string 否 上传版本地址
  |─md5Sum string 否 安装包md5值

响应示例:

{
    "code":0,
    "data":{
        "deviceModels":[
            1
        ],
        "enable":"1",
        "md5Sum":"",
        "packageSize":0.0,
        "packageType":1,
        "releaseNote":"自动加入",
        "releaseTime":1678847904000,
        "uri":"",
        "uuid":"PK-e0e0f5e4c6204fb5aeec",
        "version":"MegEye-W5K-I8_V1.3.2.RC01"
    },
    "msg":"成功"
}

1.7. 单个设备升级

基础信息

路径: /v1/api/version/upgrade

请求方法: POST

请求参数

Headers:

名称 值 必须 备注
Content-Type application/json 是

Body:

名称 类型 必须 默认值 备注
deviceUuid string 是 设备uuid
versionUuid string 是 升级版本uuid
forceUpdate boolean 否 true 是否强制升级，默认是true

Body示例:

{
    "deviceUuid": "5b99d4e34c2745eb803ab63e8520ae54",
    "versionUuid": "PK-e0e0f5e4c6204fb5aeec",
    "forceUpdate": true
}

返回数据

Headers:

名称 值 必须 备注
content-type application/json;charset=UTF-8 否

Body:

名称 类型 必须 默认值 备注
code integer 否 返回值code
msg string 否 返回值消息
data object 否 具体的返回值

响应示例:

{
    "code":0,
    "msg":"成功"
}

results matching ""

    No results matching ""