| 接口URL
https://open.ys7.com/api/v3/mall/device/package/code/active
请求
Header
|
|
|
|
|
|
|
accessToken
|
string
|
Y
|
萤石开放API访问令牌
|
|
备注:accessToken获取:萤石开放平台-南北全栈开放的全球化智能物联云平台_Works
with EZVIZ
body
|
|
|
|
|
|
|
packageDeviceId
|
string
|
Y
|
激活码id
|
|
|
deviceSerial
|
string
|
Y
|
设备序列号
|
|
|
channelNo
|
string
|
Y
|
通道号(通道号通常为1)
|
|
响应
返回数据
|
|
|
|
|
|
meta
|
object
|
meta
|
|
|
-code
|
int
|
code
|
|
|
-message
|
string
|
message
|
|
|
-moreInfo
|
object
|
moreInfo
|
|
|
data
|
array<object>
|
data
|
|
|
-packageDeviceId
|
string
|
激活码id
|
|
|
-activeCode
|
int
|
激活码激活状态码
|
0:激活成功
|
|
-activeMessage
|
string
|
激活码激活返回信息
|
|
返回示例
{
"meta": {
"code": 200,
"message": "操作成功",
"moreInfo": null
},
"data": [{
"packageDeviceId":
"",
"activeCode": 0, // 0:成功;10005:激活码信息不存在或用户不匹配;40001:无权操作,激活码激活次数超过最大值;10005:资源包配置信息不存在;40001:无权操作,激活码对应套餐已过期;40001:无权操作,激活码已过期;50000:激活码激活失败;50000:服务异常
"activeMessage":
"" // 对应code备注中的错误信息
}]
}
错误码
|
|
|
|
|
200
|
200
|
操作成功
|
|
400
|
10001
|
参数错误
|
|
500
|
500
|
服务器异常
|
|
200
|
10002
|
accessToken过期或异常
|
|
403
|
403
|
用户无权限操作
|
请求范例:
curl --location
'http://open.ys7.com/api/v3/mall/device/package/code/active' \
--header 'accessToken: 改为你的token' \
--header 'Content-Type: application/json'
\
--data '[{
"packageDeviceId":
"需要绑定的激活码",
"deviceSerial":
"需要激活的设备序列号",
"channelNo":
"需要激活的设备通道号"
}]'
|