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

路径 /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": "账号余额不足，自动支付失败"
}