全站加速

    • 全站加速 > API 文档 > 流量带宽

    流量带宽

    最近更新时间: 2026-08-31 11:35:00

    访问域名

    Host: fusion.qiniuapi.com

    认证授权

    Authorization: QBox <access_token>

    access_token 详细描述请查阅这里。

    批量查询计费带宽

    接口地址

    /v2/dcdn/bandwidth

    说明

    • 返回的数据包含开始日期和结束日期
    • 带宽的单位为 bps
    • data 只包含有流量的域名

    请求语法

    POST /v2/dcdn/bandwidth
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

    请求内容

    参数类型必要性说明
    StartDatestring必须开始日期，例如：2016-07-01
    EndDatestring必须结束日期，例如：2016-07-03
    Granularitystring必须粒度，取值：5min ／ hour ／day
    Domainsstring必须域名列表，以 ；分割
    Typestring非必须指定带宽数据类型, `""`或`"bandwidth"`查询全站加速带宽数据，`"dynbandwidth"`查询因动态加速产生的带宽数据, 未启用动态加速功能可忽略该参数

    响应状态码

    HTTP状态码含义说明
    200success成功
    400031invalid params请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`/`"dynbandwidth"`以外的值
    400032invalid host请求中存在无效的域名，请确保域名格式正确
    400080invalid start time开始时间格式错误
    400081invalid end time截止时间格式错误
    400082invalid time range时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 31 天
    500000internal error服务端内部错误，请联系技术支持

    响应内容

    200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>,
    },
    ...
  }
}
    参数类型说明
    CodeintHTTP 状态码，整型，见响应状态码
    Errorstring自定义错误码描述，字符串
    Time[]string时间点数组
    datamap带宽数据
    Domain_istring域名
    Domain_i_China[]intDomain_i 国内带宽数据，与 Time 一一对应
    Domain_i_Oversea[]intDomain_i 海外带宽数据，与 Time 一一对应

    示例

    200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    }
  }
}

    批量查询计费流量

    接口地址

    /v2/dcdn/flux

    说明

    • 返回的数据包含开始日期和结束日期
    • 流量的单位为 byte
    • data 只包含有流量的域名

    请求语法

    POST /v2/dcdn/flux
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

    请求内容

    参数类型必要性说明
    StartDatestring必须开始日期，例如：2016-07-01
    EndDatestring必须结束日期，例如：2016-07-03
    Granularitystring必须粒度，取值：5min ／ hour ／day
    Domainsstring必须域名列表，以 ；分割
    Typestring非必须`""`或`"flux"`查询全站加速流量数据，`"dynflux"`查询因动态加速产生的流量数据, 未启用动态加速功能可忽略该参数

    响应状态码

    HTTP状态码含义说明
    200success成功
    400031invalid params请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`/`"dynbandwidth"`以外的值
    400032invalid host请求中存在无效的域名，请确保域名格式正确
    400080invalid start time开始时间格式错误
    400081invalid end time截止时间格式错误
    400082invalid time range时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 30 天
    500000internal error服务端内部错误，请联系技术支持

    响应内容

    200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>,
    },
    ...
  }
}
    参数类型说明
    CodeintHTTP 状态码，整型，见响应状态码
    Errorstring自定义错误码描述，字符串
    Time[]string时间点数组
    datamap流量数据
    Domain_istring域名
    Domain_i_China[]intDomain_i 国内流量数据，与 Time 一一对应
    Domain_i_Oversea[]intDomain_i 海外流量数据，与 Time 一一对应

    示例

    200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    }
  }
}

    批量查询动态请求数

    接口地址

    /v2/dcdn/dynreqcount

    说明

    • 返回的数据包含开始日期和结束日期
    • 动态请求数单位为 次
    • data 只包含有流量的域名(依据动态加速请求日志)

    请求语法

    POST /v2/dcdn/dynreqcount
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

    请求内容

    参数类型必要性说明
    StartDatestring必须开始日期，例如：2016-07-01
    EndDatestring必须结束日期，例如：2016-07-03
    Granularitystring必须粒度，取值：5min ／ hour ／day
    Domainsstring必须域名列表，以 ；分割
    Typestring非必须数据类型, `""`或`"dynreqcount"`查询因动态加速产生的动态请求数, 其他值视为非法参数

    响应状态码

    HTTP状态码含义说明
    200success成功
    400031invalid params请求内容参数`"Type"`非法. e.g `"Type"`参数指定了除`""`(空)/`"dynreqcount"`之外的值
    400032invalid host请求中存在无效的域名，请确保域名格式正确
    400080invalid start time开始时间格式错误
    400081invalid end time截止时间格式错误
    400082invalid time range时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 30 天
    500000internal error服务端内部错误，请联系技术支持

    响应内容

    200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>,
    },
    ...
  }
}
    参数类型说明
    CodeintHTTP 状态码，整型，见响应状态码
    Errorstring自定义错误码描述，字符串
    Time[]string时间点数组
    datamap流量数据
    Domain_istring域名
    Domain_i_China[]intDomain_i 国内流量数据，与 Time 一一对应
    Domain_i_Oversea[]intDomain_i 海外流量数据，与 Time 一一对应

    示例

    200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2019-01-01 00:00:00","2019-01-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    }
  }
}

    批量查询监控带宽

    接口地址

    /v2/tune/monitoring/bandwidth

    说明

    • 返回的数据包含开始日期和结束日期
    • 带宽的单位为 bps
    • data 只包含有流量的域名
    • 监控接口侧重于全站加速服务实时统计带宽数据的实效性，不保证数据与账单完全一致
    • 支持查询3个月之内的带宽数据，/v2/dcdn/bandwidth接口无此限制

    请求语法

    POST /v2/tune/monitoring/bandwidth
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

    请求内容

    参数类型必要性说明
    StartDatestring必须开始日期，例如：2016-07-01
    EndDatestring必须结束日期，例如：2016-07-03
    Granularitystring必须粒度，取值：5min ／ hour ／day
    Domainsstring必须域名列表，以 ；分割
    Typestring非必须指定带宽数据类型, `""`或`"bandwidth"`查询全站加速带宽数据，`"dynbandwidth"`查询因动态加速产生的带宽数据, 未启用动态加速功能可忽略该参数

    响应状态码

    HTTP状态码含义说明
    200success成功
    400031invalid params请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`/`"dynbandwidth"`以外的值
    400032invalid host请求中存在无效的域名，请确保域名格式正确
    400080invalid start time开始时间格式错误
    400081invalid end time截止时间格式错误
    400082invalid time range时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 31 天
    500000internal error服务端内部错误，请联系技术支持

    响应内容

    200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>,
    },
    ...
  }
}
    参数类型说明
    CodeintHTTP 状态码，整型，见响应状态码
    Errorstring自定义错误码描述，字符串
    Time[]string时间点数组
    datamap带宽数据
    Domain_istring域名
    Domain_i_China[]intDomain_i 国内带宽数据，与 Time 一一对应
    Domain_i_Oversea[]intDomain_i 海外带宽数据，与 Time 一一对应

    示例

    200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    }
  }
}

    批量查询监控流量

    接口地址

    /v2/tune/monitoring/flow

    说明

    • 返回的数据包含开始日期和结束日期
    • 流量的单位为 byte
    • data 只包含有流量的域名
    • 监控接口侧重于全站加速服务实时统计流量数据的实效性，不保证数据与账单完全一致
    • 支持查询3个月之内的流量数据，/v2/dcdn/flux接口无此限制

    请求语法

    POST /v2/tune/monitoring/flow
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

    请求内容

    参数类型必要性说明
    StartDatestring必须开始日期，例如：2016-07-01
    EndDatestring必须结束日期，例如：2016-07-03
    Granularitystring必须粒度，取值：5min ／ hour ／day
    Domainsstring必须域名列表，以 ；分割
    Typestring非必须`""`或`"flux"`查询全站加速流量数据，`"dynflux"`查询因动态加速产生的流量数据, 未启用动态加速功能可忽略该参数

    响应状态码

    HTTP状态码含义说明
    200success成功
    400031invalid params请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`/`"dynbandwidth"`以外的值
    400032invalid host请求中存在无效的域名，请确保域名格式正确
    400080invalid start time开始时间格式错误
    400081invalid end time截止时间格式错误
    400082invalid time range时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 30 天
    500000internal error服务端内部错误，请联系技术支持

    响应内容

    200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>,
    },
    ...
  }
}
    参数类型说明
    CodeintHTTP 状态码，整型，见响应状态码
    Errorstring自定义错误码描述，字符串
    Time[]string时间点数组
    datamap流量数据
    Domain_istring域名
    Domain_i_China[]intDomain_i 国内流量数据，与 Time 一一对应
    Domain_i_Oversea[]intDomain_i 海外流量数据，与 Time 一一对应

    示例

    200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...],
    }
  }
}
    以上内容是否对您有帮助？