LinkVisual视频云存储购买服务

更新时间：2019-07-08 11:19:54

LinkVisual视频云存储购买服务

本节主要介绍厂商云端调用LinkVisual视频云存储购买服务的流程和API。提供了查询云存储套餐列表、查询云存储套餐是否可以购买、购买云存储套餐、查询云存储套餐购买订单详情、查询云存储套餐购买订单列表的服务接口。

流程说明

厂商APP端需自主完成用户付款结算的逻辑（比如厂商APP集成支付宝移动端支付SDK）。然后厂商云端调用购买接口为指定用户的设备开通视频云存储，IoT云端会从厂商的阿里云账号的余额里进行扣款（需要保证账号里有充足的余额），并为用户设备开通云存储套餐。厂商需要谨慎使用云端appkey/appsecret，注意不要泄露以免被盗用造成损失。

  • 购买流程如下：

  • 云存套餐与设备及管理员绑定

    • 设备只有一个管理员（通过配网绑定的用户），管理员可以把设备分享给其他用户。因此一个设备可以有一个管理员用户A，及分享者B、C、D。厂商APP理论上可以让A、B、C、D几个用户为该设备购买套餐，LinkVisual提供的云云对接接口对购买用户不做限制（建议厂商APP限制管理员才能购买套餐）。厂商云端调用LinkVisual的购买接口，为用户购买开通云存储，LinkVisual会记录下购买用户，购买的云存套餐归属于当前设备和管理员A。套餐会按购买先后顺序，从当前有效套餐的时间点往后追加，比如先后购买了1个月的1天事件存储套餐，1个月的3天事件存储套餐及2个月的7天连续套餐，则这三个套餐的有效期为2019-06-26 09:00:00 - 2019-07-26 08:59:59，2019-07-26 09:00:00 - 2019-08-26:08:59:59，2019-08-26 09:00:00 - 2019-10-26 08:59:59，如果在这三个套餐到期之后（如2019-11-20 09:00:00）重新购买了一份套餐，则套餐的有效期为2019-11-20 09:00:00 - 2019-12:20 08:59:59

    • 设备的云存储套餐，及套餐有效期内产生的数据，归属于设备的管理员用户A，如果这个期间设备解绑掉了，绑定到新的管理员E，原先设备产生的归属于A的数据及云存储套餐不能转移给E。这种情况下，设备绑定到了新管理员E，是没有云存储套餐及数据的。如果原管理员用户A重新绑定，原云存储套餐及数据在有效期内依然生效。

  • 购买的云存储套餐生效后，不支持退款。

  • 视频云存储套餐：

套餐名 存储周期 服务周期 价格 描述
事件录像1天云存储资源包 1天 1个月 1元 事件触发的录像，在服务周期内云端会保存1天
事件录像3天云存储资源包 3天 1个月 3元 事件触发的录像，在服务周期内云端会保存3天
事件录像7天云存储资源包 7天 1个月 4元 事件触发的录像，在服务周期内云端会保存7天
事件录像30天云存储资源包 30天 1个月 18元 事件触发的录像，在服务周期内云端会保存30天
连续录像1天云存储资源包 1天 1个月 2元 录像计划内产生的连续录像，在服务周期内云端会保存1天
连续录像3天云存储资源包 3天 1个月 6元 录像计划内产生的连续录像，在服务周期内云端会保存3天
连续录像7天云存储资源包 7天 1个月 10元 录像计划内产生的连续录像，在服务周期内云端会保存7天
连续录像30天云存储资源包 30天 1个月 40元 录像计划内产生的连续录像，在服务周期内云端会保存30天

接口详情

查询视频云存储套餐列表

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/commodity/query 1.0.2 查询视频云存储套餐列表 可选

请求参数

参数 类型 必填 默认值 描述
无

返回参数

参数 类型 必有 描述
cloudStorageCommodityList List 是 云存储套餐列表
  • CloudStorageCommodity
参数 类型 必有 描述
commodityName String 是 云存储套餐名称
commodityCode String 是 云存储套餐code
specification String 是 云存储套餐规格
type int 是 云存储套餐类型：1连续型; 2事件型
price String 是 云存储套餐价格，单位元
lifecycle int 是 存储周期
months int 是 服务周期
description String 否 云存储套餐描述
icon String 否 云存储套餐图标url

错误码

请参考公共错误码

查询云存储套餐是否可以购买

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/commodity/check 1.0.2 查询云存储套餐是否可以购买 可选

请求参数

参数 类型 必有 默认值 描述
iotId String 是 设备id
commodityCode String 是 云存储套餐code
specification String 是 云存储套餐规格

返回参数

参数 类型 必有 描述
available boolean 是 是否可以购买

错误码

请参考公共错误码

购买云存储套餐

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/commodity/buy 1.0.2 购买云存储套餐 可选

请求参数

参数 类型 必填 默认值 描述
iotId String 是 设备id
userName String 是 用户名
commodityCode String 是 云存储套餐code
specification String 是 云存储套餐规格
copies int 是 购买数量

返回参数

参数 类型 必有 描述
orderId String 是 订单id

错误码

请参考公共错误码

获取云存储套餐的订单详情

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/order/get 1.0.2 获取云存储套餐的订单详情 可选

请求参数

参数 类型 必填 默认值 描述
iotId String 是 设备id
orderId String 是 订单id

返回参数

参数 类型 必有 说明
orderId String 是 订单id
commodityCode String 是 云存储套餐code
specification String 是 云存储套餐规格
copies int 是 购买数量
startTime String 是 开始时间，格式yyyy-MM-dd HH:mm:ss
endTime String 是 结束时间，格式yyyy-MM-dd HH:mm:ss
expired int 是 是否到期
paymentStatus int 是 支付状态，0未支付，1已支付
price String 是 价格元
commodityType int 是 云存储套餐类型，1是连续型，2是事件型

错误码

请参考公共错误码

查询云存储套餐的订单列表

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/order/query 1.0.2 查询云存储套餐的订单列表 可选

请求参数

参数 类型 必填 默认值 描述
iotId String 是 设备id
pageStart int 否 0 起始页数，默认为0
pageSize int 否 20 分页大小，最大值为50

返回参数

参数名 类型 必有 说明
pageNo int 是 当前页号
pageSize int 是 页大小
pageCount int 是 总页数
total int 是 总记录数
orderList JSON 是 订单列表
  • orderList
参数 类型 必有 描述
orderId String 是 订单id
commodityCode String 是 云存储套餐code
specification String 是 云存储套餐规格
copies int 是 购买数量
startTime String 是 开始时间，格式yyyy-MM-dd HH:mm:ss
endTime String 是 结束时间，格式yyyy-MM-dd HH:mm:ss
expired int 是 是否到期
paymentStatus int 是 支付状态，0未支付，1已支付
price String 是 订单价格
commodityType int 是 云存储套餐类型，1是连续型，2是事件型

错误码

请参考公共错误码

results matching ""

    No results matching ""