查询云存储套餐列表

更新时间：2025-09-30 09:10:30

调用该接口查询视频云存储套餐列表。

---

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

请求参数：

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

请求字段	类型	必选	描述
iotId	String	否	平台为设备颁发的ID，设备的唯一标识符。 传入此值则根据设备过滤可购买的云存储套餐列表。 不传递则默认按照长电、单目等设备类型返回套餐，最终购买价格会按照实际设备类型计算，与此返回价格存在偏差

返回参数：

返回字段	类型	描述
id	String	用于识别请求记录，即对应的请求ID。
code	Int	接口返回码字段，请求成功时返回200；请求失败时返回详细的错误码。
message	String	调用失败时，返回的出错信息
data	Object	响应的结果。
commodityList	List	套餐列表。
commodityName	String	云存储套餐名称。
specification	String	云存储套餐规格。
recordType	Int	云存录像类型。1（表示连续型）；2（表示事件型）。
price	String	云存储套餐价格，单位：元。
lifecycle	Int	存储周期，单位：天。
months	Int	服务周期，单位：月。 v1.4.6废弃，为了兼容性保留，新接入优先使用下面两个新参数。
serviceTimeUnit	String	服务单位，DAY:天，MONTH:月，YEAR:年。v1.4.6引入，支持天和年。
serviceCycle	Int	服务周期，和服务单位一起使用。 v1.4.6引入，用于代替months参数。
minQuantity	Int	最小起售单位。

请求示例：

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

{
    "id": "49a7be925e******9b08ba0facf7",
    "version": "1.0",
    "request": {
        "apiVer": "1.0.0"
    },
    "params": {
        "iotId": "6vw0OrGyHFSW6EQA*****"
    }
}

成功返回示例：

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

{
    "id": "49a7be925e******9b08ba0facf7",
    "code": 200,
    "message": "success",
    "data": {
        "commodityList": [
            {
                "commodityName": "7天事件存储",
                "specification": "event_7",
                "recordType": 2,
                "price": "1.0",
                "lifecycle": 7,
                "months": 1,
                "serviceTimeUnit": "MONTH",
                "serviceCycle": 1,
                "minQuantity": 1
            }
        ]
    }
}