MeBox/115doc/115开放平台/API列表/云下载/获取云下载配额信息.md

获取云下载配额信息

基本信息

属性	内容
接口名称	获取云下载配额信息
接口版本	v1.0
接口路径	/get_quota_info
请求方法	GET
接口状态	生产环境

接口说明

获取当前授权用户各类云下载配额的使用情况和过期明细。

接口地址

https://proapi.115.com/open/offline/get_quota_info

请求方式

GET

认证方式

Authorization: Bearer access_token

请求参数

无。

请求示例

curl 'https://proapi.115.com/open/offline/get_quota_info' \
  -H 'Authorization: Bearer <access_token>'

响应字段说明

字段	类型	描述
state	boolean	状态，true表示成功
message	string	返回信息
code	int	错误码
data	object	云下载配额数据
data.package	object[]	配额类型列表
data.package[].surplus	int	该类型剩余配额
data.package[].used	int	该类型已用配额
data.package[].count	int	该类型总配额
data.package[].name	string	该类型配额名称
data.package[].expire_info	object[]	该类型配额过期明细
data.package[].expire_info[].surplus	int	明细项剩余配额
data.package[].expire_info[].expire_time	int	明细项过期时间
data.count	int	用户总配额数量
data.surplus	int	用户总剩余配额数量
data.used	int	用户总已用配额数量

响应的 code 字段(错误码)说明

错误码	说明	解决方案
990002	参数错误	检查授权信息

响应示例

{
  "state": true,
  "message": "",
  "code": 0,
  "data": {
    "package": [],
    "count": 0,
    "surplus": 0,
    "used": 0
  }
}

性能与安全说明

• 用户身份由 Bearer access_token 解析，请求参数不能指定115账号。
• 接口按应用、用户和接口维度执行频率限制。

注意事项

• 云下载配额以响应中的 data 字段为准。

修改历史

修改时间	修改说明
2025年04月01日(周二) 00:00:00	创建文档