跳到主要内容

get_license 获取当前的License信息

POST /api/v1/license/get_license​

描述​

获取当前的License信息。

访问权限​

需要登录，具备以下权限：

license:get_current

JSON参数​

请求参数如下：

{}

无参数，必须传递空对象。

请求示例：

{}

响应结果​

请求返回的HTTP状态码为200

返回结果为JSON格式的数据，您可以通过解析JSON数据来获取API调用的结果信息。结构如下：

{
  "success": true|false,
  "data"?: {
    "subject": string,   
    "issuer": string,
    "audience": string,
    "version": string,
    "sn": string,
    "deviceId": string,
    "issuedAt": string,
    "expire": string,
  },
  "errorCode"?: "option string",
  "errorMessage": "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}
备注
  • subject: 设备名称
  • issuer: 证书颁发者，目前是COOLSHARK Technology Co., Ltd. 企业名称
  • audience: 证书使用设备， 设备型号
  • version: 证书版本
  • sn: 设备序列号
  • deviceId: 设备ID，设备固件串号
  • issuedAt: 证书颁发时间
  • expire: 证书过期时间

正确结果示例：

{
  "success": true,
  "data": {
    "subject": "COOLSHARK Device License",   
    "issuer": "COOLSHARK Technology Co., Ltd.",
    "audience": "C300 Core Board",
    "version": "V1.0.0",
    "sn": "0000020100165DD9B6600100000001",
    "deviceId": "256abcd256abcd",
    "issuedAt": "2024-02-29",
    "expire": "2124-02-29"
  }
}

错误结果示例, 返回false时候需要带上错误码和错误信息：

{
  "success": false,
  "errorCode": "40000",
  "errorMessage": "no.blank.params",
  "showType": 4
}

错误码​

错误码说明错误信息显示类型
40000没有空白参数no.blank.params4
40001没有有效的Licenseno.valid.license4
提示

4 表示弹框提示错误信息。