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

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

定义描述

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 结束时间,格式yyyy-MM-dd HH:mm:ss
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.1 领取免费的云存储套餐 可选

请求参数

参数 类型 必有 默认值 描述
iotId String - 设备id
enableDefaultPlan boolean false 是否设置默认的7x24小时连续录像计划和事件录像计划
immediateUse boolean false 是否立即使用。设置true则为新领取的免费套餐立即生效;设置false则为新领取的免费套餐在之前套餐到期后生效

返回参数

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

请求参数

参数 类型 是否必填 默认值 描述
iotId String - 设备id
userName String - 用户名
commodityCode String - 云存储套餐code
specification String - 云存储套餐规格
copies int - 购买数量
enableDefaultPlan boolean false 是否设置默认的7x24小时连续录像计划和事件录像计划
immediateUse boolean false 是否立即使用。设置true则为新购套餐立即生效;设置false则为新购套餐在之前套餐到期后生效

返回参数

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

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

定义描述

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

请求参数

参数 类型 是否必填 描述
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:事件型
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ

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

定义描述

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

请求参数

参数 类型 是否必填 默认值 描述
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:事件型
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ

设置免费云存储套餐立即生效

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/freecloudstorage/enable 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 结束时间,格式yyyy-MM-dd HH:mm:ss
expired int 是否到期
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ

设置云存储套餐立即生效

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/commodity/enable 1.0.0 设置云存储套餐立即生效 可选

请求参数

参数 类型 是否必填 默认值 描述
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事件型
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ

用户云存储套餐转移

定义描述

path 版本 描述 是否需要cloudToken
/vision/customer/cloudstorage/transfer 1.0.0 用户云存储套餐转移。只支持将云存储套餐从同一个管理员账号下的一个设备转移到另一个设备的情形。 可选

请求参数

参数 类型 是否必填 默认值 描述
srcIotId String 设备ID
srcOrderId String 订单ID
dstIotId String 转移目标设备ID
enableDefaultPlan boolean false 是否设置默认的7x24小时连续录像计划和事件录像计划
immediateUse boolean false 是否立即使用。设置true则为新购套餐立即生效;设置false则为新购套餐在之前套餐到期后生效

返回参数

参数 类型 必有 描述
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 String 云存储套餐类型,1连续型,2事件型
startTimeUTC String 开始时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ
endTimeUTC String 结束时间(UTC),格式yyyy-MM-ddTHH:mm:ssZ