调用该接口购买云存储套餐。

路径 /vision/customer/cloudstorage/commodity/buy
版本号 1.0.8
协议 HTTP,HTTPS
请求方法 POST
是否需要用户身份鉴权 可选
超时时间 10000

请求参数

名称 类型 是否必选 示例值 描述
iotId String QIuozfUcxRX6frOTO4dKz2**** 设备ID,生活物联网平台为设备颁发的ID,设备的唯一标识符。
userName String 1581053**** 购买云存储套餐的用户名。可传用户注册手机号、生活物联网平台的用户身份ID、客户自有账号用户ID,云端仅做保存并且在查询的时候返回。
commodityCode String ilopLV*****Resource 云存储套餐编码。
specification String e****Resource_7 云存储套餐规格。
copies Int 1 购买的数量。
enableDefaultPlan Boolean true 是否设置默认的7x24小时录像计划和事件录像计划。
immediateUse Boolean true 是否立即使用。true(表示新购套餐立即生效开始使用);false(表示新购套餐在之前套餐到期后才开始生效使用)。
preRecordDuration Int 5 事件录像预录时长,取值范围:0~5秒。
recordDuration Int 10 事件录像时长,取值范围:0~30秒。
eventRecordProlong Boolean true 是否延长事件录像。true(表示在事件录像过程中,持续触发的事件会延长录像至事件结束);false(表示每个事件固定录制30秒内的录像)。
maxRecordFileDuration Int 1800 连续录像文件最大的时长,单位:秒。取值600~3600。
userId String 1581053**** 用户ID,可空。
deviceNoOwner Boolean false 设备是否尚未绑定管理员。

返回数据

名称 类型 示例值 描述
code Int

接口返回码。200表示成功。

message String

调用失败时,返回的出错信息。

localizedMsg String

本地语言的错误消息。

data JSON

响应的结果。

orderId String

订单ID。

示例

请求示例

{
	"id": "1509086454180",
	"version": "1.0",
	"request":{
		"apiVer": "1.0.8"
	},
	"params":{
		"iotId": "QIuozfUcxRX6frOTO4dKz2****",
		"userName": "1581053****",
		"commodityCode": "ilopLV*****Resource",
		"specification": "e****Resource_7",
		"copies":1,
		"enableDefaultPlan":true,
		"immediateUse":true,
		"preRecordDuration":5,
		"recordDuration":10,
		"eventRecordProlong":true,
		"maxRecordFileDuration":1800,
		"userId": "1581053****",
		"deviceNoOwner":false
	}
}

正常返回示例

JSON格式

{
    "code": 200, 
    "data": {
        "orderId": "20190****7292734"
    }, 
    "id": "5fd8d62c-4b0b-4ce4-a485-a083b15604a0"
}

异常返回示例

JSON格式

{
    "code": 100111, 
    "id": "8c4eb5ae-1ab9-4859-86ca-7fc2c0a02a90", 
    "localizedMsg": "账号余额不足,自动支付失败", 
    "message": "账号余额不足,自动支付失败"
}