LinkVisual视频云存储购买服务
更新时间：2019-05-28 17:21:46
LinkVisual视频云存储购买服务
本节主要介绍厂商云端调用LinkVisual视频云存储购买服务的流程和API。提供了查询云存储套餐列表、查询云存储套餐是否可以购买、购买云存储套餐、查询云存储套餐购买订单详情、查询云存储套餐购买订单列表的服务接口。
流程说明
厂商APP端需自主完成用户付款结算的逻辑（比如厂商APP集成支付宝移动端支付SDK）。然后厂商云端调用购买接口为指定用户的设备开通视频云存储，IoT云端会从厂商的阿里云账号的余额里进行扣款，并为用户设备开通云存储套餐（厂商需要谨慎使用云端AK/SK,注意不要泄露以免造成损失）。
| 套餐名 |
存储周期 |
服务周期 |
价格 |
描述 |
| 事件录像1天云存储资源包 |
1天 |
1个月 |
1元 |
|
| 事件录像3天云存储资源包 |
3天 |
1个月 |
3元 |
|
| 事件录像7天云存储资源包 |
7天 |
1个月 |
4元 |
|
| 事件录像30天云存储资源包 |
30天 |
1个月 |
18元 |
|
| 连续录像1天云存储资源包 |
1天 |
1个月 |
2元 |
|
| 连续录像3天云存储资源包 |
3天 |
1个月 |
6元 |
|
| 连续录像7天云存储资源包 |
7天 |
1个月 |
10元 |
|
| 连续录像30天云存储资源包 |
30天 |
1个月 |
40元 |
接口详情
查询视频云存储套餐列表
定义描述
| path |
版本 |
描述 |
是否需要用户身份鉴权 |
| /vision/customer/cloudstorage/commodity/query |
1.0.1 |
查询视频云存储套餐列表 |
是，客户端SDK需启用身份的鉴权 |
请求参数
返回参数
| 参数 |
类型 |
必有 |
描述 |
| cloudStorageCommodityList |
List |
是 |
云存储套餐列表 |
| 参数 |
类型 |
必有 |
描述 |
| commodityName |
String |
是 |
云存储套餐名称 |
| commodityCode |
String |
是 |
云存储套餐code |
| specification |
String |
是 |
云存储套餐规格 |
| type |
int |
是 |
云存储套餐类型：1连续型; 2事件型 |
| price |
String |
是 |
云存储套餐价格，单位元 |
| lifecycle |
int |
是 |
存储周期 |
| months |
int |
是 |
服务周期 |
| description |
String |
否 |
云存储套餐描述 |
| icon |
String |
否 |
云存储套餐图标url |
错误码
请参考公共错误码
查询云存储套餐是否可以购买
定义描述
| path |
版本 |
描述 |
是否需要用户身份鉴权 |
| /vision/customer/cloudstorage/commodity/check |
1.0.1 |
查询云存储套餐是否可以购买 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必有 |
默认值 |
描述 |
| iotId |
String |
是 |
|
设备id |
| commodityCode |
String |
是 |
|
云存储套餐code |
| specification |
String |
是 |
|
云存储套餐规格 |
返回参数
| 参数 |
类型 |
必有 |
描述 |
| available |
boolean |
是 |
是否可以购买 |
错误码
请参考公共错误码
购买云存储套餐
定义描述
| path |
版本 |
描述 |
是否需要用户身份鉴权 |
| /vision/customer/cloudstorage/commodity/buy |
1.0.1 |
购买云存储套餐 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必填 |
默认值 |
描述 |
| iotId |
String |
是 |
|
设备id |
| userName |
String |
是 |
|
用户名 |
| commodityCode |
String |
是 |
|
云存储套餐code |
| specification |
String |
是 |
|
云存储套餐规格 |
| copies |
int |
是 |
|
购买数量 |
返回参数
| 参数 |
类型 |
必有 |
描述 |
| orderId |
String |
是 |
订单id |
错误码
请参考公共错误码
获取云存储套餐的订单详情
定义描述
| path |
版本 |
描述 |
是否需要用户身份鉴权 |
| /vision/customer/cloudstorage/order/get |
1.0.1 |
获取云存储套餐的订单详情 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必填 |
默认值 |
描述 |
| iotId |
String |
是 |
|
设备id |
| orderId |
String |
是 |
|
订单id |
返回参数
| 参数 |
类型 |
必有 |
说明 |
| orderId |
String |
是 |
订单id |
| commodityCode |
String |
是 |
云存储套餐code |
| specification |
String |
是 |
云存储套餐规格 |
| copies |
int |
是 |
购买数量 |
| startTime |
Date |
是 |
开始时间 |
| endTime |
Date |
是 |
结束时间 |
| expired |
int |
是 |
是否到期 |
| paymentStatus |
int |
是 |
支付状态，0未支付，1已支付 |
| price |
String |
是 |
价格元 |
错误码
请参考公共错误码
查询云存储套餐的订单列表
定义描述
| path |
版本 |
描述 |
是否需要用户身份鉴权 |
| /vision/customer/cloudstorage/order/query |
1.0.1 |
查询云存储套餐的订单列表 |
是，客户端SDK需启用身份的鉴权 |
请求参数
| 参数 |
类型 |
必填 |
默认值 |
描述 |
| iotId |
String |
是 |
|
设备id |
| pageStart |
int |
否 |
0 |
起始页数，默认为0 |
| pageSize |
int |
否 |
20 |
分页大小，最大值为50 |
返回参数
| 参数名 |
类型 |
必有 |
说明 |
| cloudStorageCommodityOrderList |
JSON |
是 |
订单列表 |
| total |
int |
是 |
订单总数 |
| currentCount |
int |
是 |
当前订单数量 |
- CloudStorageCommodityOrder
| 参数 |
类型 |
必有 |
描述 |
| orderId |
String |
是 |
订单id |
| commodityCode |
String |
是 |
云存储套餐code |
| specification |
String |
是 |
云存储套餐规格 |
| copies |
int |
是 |
购买数量 |
| startTime |
Date |
是 |
开始时间 |
| endTime |
Date |
是 |
结束时间 |
| expired |
int |
是 |
是否到期 |
| paymentStatus |
int |
是 |
支付状态，0未支付，1已支付 |
| price |
String |
是 |
订单价格 |
错误码
请参考公共错误码