查询计费数据¶

1. 接口描述¶

接口请求路径：POST /prod-api/acdn/tcdn/statistics/describeBillingData

describeBillingData 用于查询指定域名或当前账号全部域名的计费数据，支持计费流量、计费带宽与 HTTPS 请求数。单次查询时间跨度最长 90 天。账号需具备 tcdn:DescribeBillingData 权限。

Token 获取方式见密钥鉴权。

注意：metric 为 flux 或 bandwidth 时，返回的明细值与汇总值已按账号增值系数换算，可能高于上游原始计费值。

2. 输入参数¶

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	类型	描述
params	是	Params	时间筛选
domain	否	String	单个加速域名，须属于当前账号；不传表示全部域名。示例值：`lw111.demo.com`
metric	是	String	计费统计类型。取值：`flux`（计费流量，单位 byte）、`bandwidth`（计费带宽，单位 bps）、`https`（HTTPS 请求数，单位次）。示例值：`flux`
interval	是	String	时间粒度。取值：`min`（1 分钟，查询区间不超过 24 小时）、`5min`（5 分钟，查询区间不超过 31 天）、`hour`（1 小时，查询区间不超过 31 天）、`day`（天，查询区间大于 31 天）。示例值：`5min`
area	是	String	加速区域。取值：`mainland`（中国境内）、`overseas`（中国境外）。示例值：`mainland`

3. 输出参数¶

参数名称	类型	描述
code	Integer	状态码。示例值：`200`
msg	String	提示信息。示例值：`操作成功`
data	Object	计费数据响应
data.requestId	String	上游请求 ID，定位问题时请提供该值
data.interval	String	时间粒度，与请求一致。示例值：`5min`
data.data	[ResourceBillingData]	计费数据明细

4. 示例¶

示例1 查询计费流量¶

输入示例¶

{
  "metric": "flux",
  "interval": "5min",
  "area": "mainland",
  "params": {
    "beginTime": "2025-10-15 00:00:00",
    "endTime": "2025-10-15 23:59:59"
  }
}

代码调用¶

请将 {登录域名}、token 替换为实际值。

cURLJavaGo

curl -X POST 'https://{登录域名}/prod-api/acdn/tcdn/statistics/describeBillingData' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.xxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
  "metric": "flux",
  "interval": "5min",
  "area": "mainland",
  "params": {
    "beginTime": "2025-10-15 00:00:00",
    "endTime": "2025-10-15 23:59:59"
  }
}'

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class DescribeBillingDataTest {

    public static void main(String[] args) throws Exception {
        String url = "https://{登录域名}/prod-api/acdn/tcdn/statistics/describeBillingData";
        String token = "eyJhbGciOiJIUzUxMiJ9.xxxxxx";

        String requestBody = "{"
                + "\"metric\":\"flux\","
                + "\"interval\":\"5min\","
                + "\"area\":\"mainland\","
                + "\"params\":{\"beginTime\":\"2025-10-15 00:00:00\",\"endTime\":\"2025-10-15 23:59:59\"}"
                + "}";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpPost httpPost = new HttpPost(url);
            httpPost.setHeader("Authorization", "Bearer " + token);
            httpPost.setEntity(new StringEntity(requestBody, ContentType.APPLICATION_JSON));

            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                int statusCode = response.getStatusLine().getStatusCode();
                String body = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("Status Code: " + statusCode);
                System.out.println("Body: " + body);
            }
        }
    }
}

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://{登录域名}/prod-api/acdn/tcdn/statistics/describeBillingData"
    token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"

    requestBody := []byte(`{
  "metric": "flux",
  "interval": "5min",
  "area": "mainland",
  "params": {
    "beginTime": "2025-10-15 00:00:00",
    "endTime": "2025-10-15 23:59:59"
  }
}`)

    req, err := http.NewRequest(http.MethodPost, url, bytes.NewReader(requestBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+token)
    req.Header.Set("Content-Type", "application/json")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println("Status Code:", resp.StatusCode)
    fmt.Println("Body:", string(body))
}

输出示例¶

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "requestId": "f39e4a4e-4379-4c2f-8e3b-42d7a2f9f5e8",
    "interval": "5min",
    "data": [
      {
        "resource": "all",
        "billingData": [
          {
            "metric": "flux",
            "detailData": [
              { "time": "2025-10-15 00:00:00", "value": 10240 },
              { "time": "2025-10-15 00:05:00", "value": 20480 }
            ],
            "summarizedData": { "name": "sum", "value": 30720 }
          }
        ]
      }
    ]
  }
}

5. 错误码¶

HTTP 状态码 / 业务提示	描述
200	成功
401	未鉴权或 Token 无效
403	无权限
error code:{0},message:{1}	上游查询失败，`{0}` 为错误码，`{1}` 为原因

6. 数据模型¶

Params¶

时间筛选。格式为 yyyy-MM-dd HH:mm:ss，单次查询时间跨度最长 90 天。

参数名称	必选	类型	描述
beginTime	是	String	开始时间。示例值：`2025-10-15 00:00:00`
endTime	是	String	结束时间。示例值：`2025-10-15 23:59:59`

ResourceBillingData¶

单个资源的计费数据。

参数名称	类型	描述
resource	String	资源标识。未指定 `domain` 时为 `all`，否则为域名。示例值：`all`
billingData	[BillingMetricData]	计费指标数据

BillingMetricData¶

单个计费指标的趋势与汇总。

参数名称	类型	描述
metric	String	统计指标，与请求一致。示例值：`flux`
detailData	[TimestampData]	按时间粒度排列的明细数据
summarizedData	SummarizedData	汇总数据

TimestampData¶

单个时间点的数据。

参数名称	类型	描述
time	String	时间点。示例值：`2025-10-15 00:00:00`
value	Float	数据值，单位随 `metric` 而定。示例值：`10240`

SummarizedData¶

查询区间内的汇总数据。

参数名称	类型	描述
name	String	汇总方式，如 `sum`、`max`。示例值：`sum`
value	Float	汇总值。示例值：`30720`