获取应用OpenAPI使用详情
... 2025-5-9 大约 2 分钟
# 获取应用OpenAPI使用详情
# 接口说明
本接口用于获取应用OpenAPI使用详情
# 权限说明
本接口需要拥有以下任意一项权限：
scope.file.queryablescope.drive.readonlyscope.drive.file.metadatascope.drive.file.metadata.readonly
# 请求格式
# 请求参数
# 路径参数
无
# 查询参数
无
# 请求体
无
# 响应参数
# 请求体
| 参数名 | 类型 | 描述 |
|---|---|---|
| ret | integer | 业务返回码 |
| msg | string | 业务返回码描述 |
| data | JsonResourceUseInfos | 使用详情 |
# ResourceUseInfos
| 参数名 | 类型 | 描述 |
|---|---|---|
| clientID | integer | 应用ID |
| resourceType | string | 类型 1:限免 2:资源包 |
| beginDate | integer | 资源包开始时间 |
| endDate | integer | 资源包结束时间 |
| total | integer | 总数 |
| useTotal | integer | 已使用总数 |
# 请求包体
GET /openapi/drive/v2/util/resource-use HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Length: 0
1
2
3
4
5
6
2
3
4
5
6
1
2
3
4
5
6
2
3
4
5
6
# 示例
curl --location --request GET 'https://docs.qq.com/openapi/drive/v2/util/resource-use' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID'
1
2
3
4
2
3
4
1
2
3
4
2
3
4
# 响应包体
HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 3
Connection: keep-alive
{
"ret": 0,
"msg": "Succeed",
"data": {
"resourceUseInfos": [
{
"clientID": "8a441eb3a0694876884da2922adc7686",
"resourceType": "2",
"beginDate": 1745769600,
"endDate": 1745789600,
"total": 50,
"useTotal": 50
},
{
"clientID": "8a441eb3a0694876884da2922adc7686",
"resourceType": "1",
"total": 10,
"useTotal": 10
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
# 错误码
| 错误码 | 错误说明 | 排查建议 |
|---|---|---|
| 10313 | Access-Token 为空 | HTTP Header 里 Access-Token 校验失败，请参考示例中的携带方式，检查相应字段。详情请见Headers。 |
| 10303 | Open-Id 错误 | HTTP Header 里 Open-Id 与预期不符，可能的原因有：- Open-Id 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。- Open-Id 与 Access-Token 不匹配，请检查 Header 内容和获取 Token 接口回包是否一致。 |
| 10302 | Client-Id 错误 | HTTP Header 里 Client-Id 与预期不符，可能的原因有：- Client-Id 为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。- Client-Id 与 Access-Token 不匹配，请检查 Header 内容和调用获取 Token 接口接口时参数中的 Client-Id 是否一致。 |
| 37019 | Token 校验失败，错误或过期 | 检查位于 HTTP Header 中的 Access-Token 是否正确，获取 Token 的方式请查阅授权流程以及获取 Token 接口 |