获取云盘基础信息
获取当前用户的云盘基础信息,包括云盘空间总量、已使用量、到期时间、扩容包列表等。
接口地址:
text
/papi/file/cloudDisk请求方式:
text
POSTHeader 参数:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-Access-Key | string | 是 | API 访问密钥 ID,鉴权方式见 接口规则 |
| X-Signature | string | 是 | 签名值,Base64 编码的 HMAC-SHA256 计算结果 |
| X-Timestamp | string | 是 | 毫秒级 Unix 时间戳(13 位) |
| X-Nonce | string | 是 | 随机字符串,10~32 位小写字母+数字 |
Body 参数:
无请求体参数。
响应参数:
| 参数 | 类型 | 说明 |
|---|---|---|
| code | integer | 错误码,参见 错误码说明 |
| data | object | 返回数据 |
| ├─ cloudDisk | integer | 当前云盘空间 |
| ├─ cloudDiskUsed | integer | 已使用云盘空间 |
| ├─ cloudDiskExpire | integer | 云盘到期时间 |
| ├─ cloudDiskFree | integer | 云盘免费空间大小 |
| ├─ cloudDiskExpireAmount | integer | 云盘 7 天内到期空间大小 |
| ├─ hasContainer | boolean | 是否拥有云手机 |
| ├─ cloudDiskExpandList | array[object] | 云盘扩容包列表 |
| ├─├─ changeAmount | integer | 扩容包大小 |
| ├─├─ expirationTime | integer | 扩容包过期时间 |
| ├─├─ skuCode | string | SKU 编码 |
| ├─├─ packageCode | string | 套餐编码 |
| ├─├─ ExpiringFlag | boolean | 是否即将到期 |
| ├─├─ expireTime | integer | 订单的扩容包过期时间 |
| msg | string | 错误提示 |
响应示例:
json
{
"code": 0,
"data": {
"cloudDisk": 0,
"cloudDiskUsed": 0,
"cloudDiskExpire": 0,
"cloudDiskFree": 0,
"cloudDiskExpireAmount": 0,
"hasContainer": false,
"cloudDiskExpandList": [
{
"changeAmount": 0,
"expirationTime": 0,
"skuCode": "",
"packageCode": "",
"ExpiringFlag": false,
"expireTime": 0
}
]
},
"msg": ""
}