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

介绍

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

购买流程如下。

  • 免费赠送的云存储每个设备只能领用一次,换一个账号绑定不可以再领取
  • 云存套餐与设备、设备当前管理员唯一关联
    • 设备只有一个管理员(通过配网绑定的用户),管理员可以把设备分享给其他用户。因此一个设备可以有一个管理员用户A,及分享者B、C、D。厂商APP理论上可以让A、B、C、D几个用户为该设备购买套餐,LinkVisual提供的云云对接接口对购买用户不做限制(建议厂商APP限制管理员才能购买套餐)。厂商云端调用LinkVisual的购买接口,为用户购买开通云存储,LinkVisual会记录下购买用户,购买的云存套餐归属于当前设备和管理员A。套餐会按购买先后顺序生效,新购买的套餐从当前有效套餐结束时间点往后追加。
    • 设备的云存储套餐,及套餐有效期内产生的数据,归属于设备的管理员用户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个月 1.2元 录像计划内产生的连续录像,在服务周期内云端会保存1天
    3天循环连续云存储月套餐 3天 1个月 3.6元 录像计划内产生的连续录像,在服务周期内云端会保存3天
    7天循环连续云存储月套餐 7天 1个月 6元 录像计划内产生的连续录像,在服务周期内云端会保存7天
    30天循环连续云存储月套餐 30天 1个月 24元 录像计划内产生的连续录像,在服务周期内云端会保存30天
    1天循环事件云存储年套餐 1天 12个月 10元 事件触发的录像,在服务周期内云端会保存1天
    3天循环事件云存储年套餐 3天 12个月 30元 事件触发的录像,在服务周期内云端会保存3天
    7天循环事件云存储年套餐 7天 12个月 40元 事件触发的录像,在服务周期内云端会保存7天
    30天循环事件云存储年套餐 30天 12个月 180元 事件触发的录像,在服务周期内云端会保存30天
    1天循环连续云存储年套餐 1天 12个月 12元 录像计划内产生的连续录像,在服务周期内云端会保存1天
    3天循环连续云存储年套餐 3天 12个月 36元 录像计划内产生的连续录像,在服务周期内云端会保存3天
    7天循环连续云存储年套餐 7天 12个月 60元 录像计划内产生的连续录像,在服务周期内云端会保存7天
    30天循环连续云存储年套餐 30天 12个月 240元 录像计划内产生的连续录像,在服务周期内云端会保存30天

查询免费的云存储套餐详情

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/freecloudstorage/get 1.0.0 查询免费的云存储套餐详情 可选

请求参数

参数 类型 必有 默认值 描述
iotId String - 设备id

返回参数

参数 类型 必有 描述
type int 云存储套餐类型:1连续型;2事件型
lifecycle int 存储周期
months int 服务周期,单位月
consumed int 是否已经领取过,0是尚未领取,1是已领取
startTime String 开始时间,格式yyyy-MM-dd HH:mm:ss
endTime String
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
expired int 是否到期

领取免费的云存储套餐

定义描述

path 版本 描述 是否要cloudToken
/vision/customer/freecloudstorage/consume 1.0.0 领取免费的云存储套餐 可选

请求参数

参数 类型 必有 默认值 描述
iotId String - 设备id
enableDefaultPlan boolean false 是否设置默认的7x24小时连续录像计划和事件录像计划

返回参数

参数 类型 必有 描述
type int 云存储套餐类型:1连续型;2事件型
lifecycle int 存储周期
months int 服务周期,单位月
consumed int 是否已经领取过,0是尚未领取,1是已领取
startTime String 开始时间,格式yyyy-MM-dd HH:mm:ss
endTime String 结束时间,格式yyyy-MM-dd HH:mm:ss
startTimeUTC String 开始时间(UTC),格式yyyy-MM-dd HH:mm:s
endTimeUTC String 结束时间(UTC),格式yyyy-MM-dd HH:mm:s
expired int 是否到期

查询视频云存储套餐列表

定义描述

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

请求参数

返回参数

参数 类型 是否必填 描述
cloudStorageCommodityList List 云存储套餐列表

cloudStorageCommodityList

参数 类型 是否必填 描述
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.3 购买云存储套餐 可选

请求参数

参数 类型 是否必填 默认值 描述
iotId String - 设备id
userName String - 用户名
commodityCode String - 云存储套餐code
specification String - 云存储套餐规格
copies int - 购买数量
enableDefaultPlan boolean false 是否设置默认的7x24小时连续录像计划和事件录像计划

返回参数

参数 类型 是否必填 描述
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 支付状态
  • 1:已支付
  • 0:未支付
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 支付状态
  • 1:已支付
  • 0:未支付
price String 订单价格
commodityType int 云存储套餐类型
  • 1:连续型
  • 2:事件型