调用该接口购买云存储套餐。
路径 | /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": "账号余额不足,自动支付失败"
}