在线算法授权
接口描述
为在线设备进行算法授权，支持批量授权多个设备。
请求说明
| 接口ID |
协议 |
方法 |
PATH |
| 49 |
HTTPS |
POST |
/openapi/v1/alg/consumes/online_grant |
PATH参数
无
URL参数
| 参数 |
类型 |
必填 |
说明 |
| accesskey_id |
string |
是 |
参见签名认证 |
| expires |
int |
是 |
参见签名认证 |
| signature |
string |
是 |
参见签名认证 |
HTTP请求头
| 字段 |
值 |
| Content-Type |
application/json |
请求参数
请求参数以Json格式放置于Body中，如下：
| 参数 |
类型 |
必填 |
说明 |
| product_id |
int |
是 |
算法商品ID |
| sns |
array |
是 |
设备序列号列表 |
请求示例
POST https://open.vzicloud.com/openapi/v1/alg/consumes/online_grant?accesskey_id=8d9EsDAD2115Q5PM8tuP6g1IdAglkayp&expires=1619022787&signature=G29eTBjMm0gZF7cpXNLX7Hrn0yM%3D HTTP/1.1
Host: open.vzicloud.com
Content-Length: 78
Content-Type: application/json
{
"product_id": 1,
"sns": ["abc123456789", "def123456789", "ghi123456789"]
}
返回说明
返回参数
| 参数 |
类型 |
说明 |
| successes |
array |
授权成功的设备列表 |
| + sn |
string |
设备序列号 |
| failures |
array |
授权失败的设备列表 |
| + sn |
string |
设备序列号 |
| + error |
object |
错误信息 |
| ++ code |
int |
错误代码 |
| ++ message |
string |
错误描述 |
注意：授权成功仅表示已成功消费授权数量，不表示授权码已下发给设备并生效，需要通过调用遍历算法授权列表接口的state字段来判断是否真的授权成功或失败
返回示例
{
"successes": [
{
"sn": "abc123456789"
},
{
"sn": "def123456789"
}
],
"failures": [
{
"sn": "ghi123456789",
"error": {
"code": 40001,
"message": "设备离线"
}
}
]
}