购买云存储套餐

更新时间：2025-03-04 19:49:45

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

描述	值
路径	/platform/customer/cloudstorage/commodity/buy
版本号	1.0.0
协议	HTTPS
请求方法	POST

请求参数：

公共请求参数见公共请求参数

请求字段	类型	必选	描述
iotId	String	是	平台为设备颁发的ID，设备的唯一标识符。
userName	String	是	购买云存储套餐的用户名。可传用户注册手机号、平台的用户身份ID、客户自有账号用户ID，云端仅做保存并且在查询的时候返回。
specification	String	是	云存储套餐规格。
copies	String	是	购买的数量。
immediateUse	boolean	否	是否立即使用。true（表示新购套餐立即生效开始使用）；false（表示新购套餐在之前套餐到期后才开始生效使用）。默认false
preRecordDuration	Int	否	事件录像预录时长，取值范围：0～5秒。
recordDuration	Int	否	事件录像时长，取值范围：0~30秒。
eventRecordProlong	boolean	否	是否延长事件录像。true（表示在事件录像过程中，持续触发的事件会延长录像至事件结束）；false（表示每个事件固定录制30秒内的录像）。

返回参数：

返回字段	类型	描述
id	String	用于识别请求记录，即对应的请求ID。
code	Int	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码。
message	String	调用失败时，返回的出错信息
data	Object	响应的结果。
orderId	String	订单ID。

请求示例：

x-ca-key: xxxxxxxx
x-ca-timestamp: 1728634151000
x-ca-nonce: 7b25fc15b9434dd98587a077a92b7e42
x-ca-signature: yyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy
Content-Type: application/json;charset=UTF-8

{
    "id": "9680e1fd91******8f01eb7fd99",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "iotId": "6vw0OrGyHFSW6EQA*****",
        "userName": "1376981****",
        "specification": "event_7",
        "copies": 1,
        "immediateUse": true,
        "preRecordDuration": 0,
        "recordDuration": 0,
        "eventRecordProlong": true
    }
}

成功返回示例：

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
    "id": "49a7be925******e9b08ba0facf7",
    "code": 200,
    "message": "success",
    "data": {
        "orderId": "20190****7292734"
    }
}

请求参数：​

返回参数：​

请求示例：​

成功返回示例：​

请求参数：

返回参数：

请求示例：

成功返回示例：