1. 快速查阅区

1.1 核心接口概览

1.2 核心约束

• 请求域名: fusion.qiniuapi.com
• 鉴权方式: QBox 鉴权（详见 鉴权指南）；
• 数据保留: 30 天，例如：当前日期为 2026-01-31，则只提供 2026-01-01 ~ 2026-01-30 的日志；
• 日志粒度: 每小时一个 gz 压缩文件，单小时内日志过大会进行切分(分片大小128MB)；
• 日志延迟: 6小时，例如：1月18日0点-1点的日志，会在1月18日8点-10点左右可下载。

2. 详细接口说明

2.1 获取日志下载链接

基本信息

• 请求方法: POST
• 接口地址: https://fusion.qiniuapi.com/v2/tune/log/list

请求参数

domains 为 string 类型，传数组会报 400。

请求示例

curl -X POST 'https://fusion.qiniuapi.com/v2/tune/log/list' \
  -H 'Host: fusion.qiniuapi.com' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: QBox <AK>:<Sign>' \
  -d '{"day":"2026-02-12","domains":"test.example.com"}'

响应参数

响应示例

成功 (HTTP 200):

{
  "code": 200,
  "error": "",
  "data": {
    "test.example.com": [
      {
        "name": "v2/test.example.com_2026-02-12-07_part-00000.gz",
        "size": 311,
        "mtime": 1770868332,
        "url": "https://fusionlog.qiniu.com/v2/test.example.com_2026-02-12-07_part-00000.gz?e=...&token=...",
        "md5": "",
        "domain": "test.example.com"
      }
    ]
  }
}

data 按域名分组，每个域名对应一个日志文件数组。无数据时对应域名的数组为空。

失败:

{
    "code": 400,
    "error": "请求参数格式错误",
    "data": {}
}

日志格式

每行一条记录，字段顺序如下：

示例日志:

148.153.188.135 UNKNOWN 1 [13/Feb/2026:12:09:15 +0800] "GET https://test.example.com/qiniu_do_not_delete.gif HTTP/1.1" 403 345 "-" "Q-uc-client"

字段说明:

格式说明: Method+URL+Protocol 被 "" 包裹为一组，Referer 和 UserAgent 各自被 "" 包裹。

3. 常见问题

3.1 专属错误码

3.2 最佳实践

• 查询时机: 日志延迟6小时，查询前日日志，建议次日上午查询
• 下载链接: url 含时效签名，获取后尽快下载
• domains 格式: string 类型分号分隔，同用量统计
• 日志命名: 域名_日期-小时_part-序号.gz，按小时拆分
• 批量下载: 多域名一次查询，响应按域名分组

参考: 鉴权详见 鉴权指南，错误码详见 公共错误码&通用约束。