接口功能介绍
调用本接口查询计费账单详情
使用说明
单个用户一分钟限制调用10000次,并发不超过100。
接口详情
请求方式:get
请求路径:/usage-management/query-bill-detail-list
请求参数
参数名 | 类型 | 是否必填 | 名称 | 说明 |
---|---|---|---|---|
start_month | string | 是 | 开始月份 | 如2021-01,开始月份和结束月份的跨度不能超过12个月 |
end_month | string | 是 | 结束月份 | 如2021-12,开始月份和结束月份的跨度不能超过12个月 |
product_code | string | 否 | 产品编码 | 支持产品类型:“005”(视频直播) |
page_num | int | 否 | 页码 | 不传默认1 |
page_size | int | 否 | 页大小 | 不传默认20 |
响应参数
参数 | 类型 | 是否必传 | 名称及描述 |
---|---|---|---|
code | int | 是 | 状态码 |
message | string | 是 | 描述信息 |
data | object | 否 | 返回结果 |
data.result | list< object> | 否 | 返回结果列表 |
data.result[*].start_time | string | 否 | 账单用量开始时间 |
data.result[*].end_time | string | 否 | 账单用量结束时间 |
data.result[*].product_code | string | 否 | 产品编码 |
data.result[*].billing_type_name | string | 否 | 计费方式 |
data.result[*].billing_unit | string | 否 | 计费值单位 |
data.result[*].total_value | decimal | 否 | 计费值 |
data.result[*].billing_area | int | 否 | 计费区域代码,0(中国大陆) |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/usage-management/query-bill-detail-list
请求示例
请求:https://cdnapi-global.ctapi.ctyun.cn/usage-management/query-bill-detail-list?start_month=2022-07&end_month=2022-09&product_code=005
正确响应示例
{
"code": 100000,
"message": "success",
"data": {
"result": [
{
"start_time": "2022-08-01 00:00:00",
"total_value": 1472658.58,
"end_time": "2022-08-31 23:59:59",
"billing_type_name": "日95带宽值月平均",
"product_code": "005",
"billing_area": 0,
"billing_unit": "Mbps"
},
{
"start_time": "2022-07-01 00:00:00",
"total_value": 890088.14,
"end_time": "2022-07-31 23:59:59",
"billing_type_name": "日95带宽值月平均",
"product_code": "005",
"billing_area": 0,
"billing_unit": "Mbps"
}
]
}
}
错误码请参考:参数code和message含义