下载算法授权文件

接口描述

下载指定设备或预授权数据的算法授权文件，用于离线设备的授权安装。

请求说明

接口ID 协议 方法 PATH
53 HTTPS POST /openapi/v1/alg/consumes/licenses

PATH参数

无

URL参数

参数 类型 必填 说明
accesskey_id string 是 参见签名认证
expires int 是 参见签名认证
signature string 是 参见签名认证

HTTP请求头

字段 值
Content-Type application/json

请求参数

请求参数以Json格式放置于Body中，如下：

参数 类型 必填 说明
sns array 否 设备序列号列表（与offline_grant_id二选一）
offline_grant_id int 否 预授权数据ID（与sns二选一）

注：sns和offline_grant_id必须且只能填写其中一个参数。

请求示例

根据设备序列号下载

POST https://open.vzicloud.com/openapi/v1/alg/consumes/licenses?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 64
Content-Type: application/json

{
  "sns": ["abc123456789", "def123456789"]
}

根据预授权数据ID下载

POST https://open.vzicloud.com/openapi/v1/alg/consumes/licenses?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 32
Content-Type: application/json

{
  "offline_grant_id": 2001
}

返回说明

返回参数

参数 类型 说明
successes array 下载成功的设备列表
+ sn string 设备序列号
failures array 下载失败的设备列表
+ sn string 设备序列号
+ error object 错误信息
++ code int 错误代码
++ message string 错误描述
license string 授权文件内容（RSA加密的Base64字符串）

注：返回参数里可能还包含其他信息但未在上面的表格内列出，请勿使用！

返回示例

{
  "successes": [
    {
      "sn": "abc123456789"
    },
    {
      "sn": "def123456789"
    }
  ],
  "failures": [],
  "license": "encrypted_license_base64_string_containing_all_device_authorizations..."
}

results matching ""

    No results matching ""