CDN

    • CDN > API 文档 > API列表

    API列表

    最近更新时间: 2026-03-25 14:05:53

    1. 域名与鉴权绑定规范

    接入域名 鉴权方式 QPS 覆盖模块
    api.qiniu.com Qiniu (请求内容签名) 10 域名管理、域名配置
    fusion.qiniuapi.com QBox (路径签名) 5-10 用量统计 / 运营统计 / 缓存管理 / 证书管理 / 日志下载

    2. 文档索引

    编号 文档 内容
    01 鉴权指南 鉴权指南 (Qiniu + QBox 签名算法)
    02 公共错误码 & 通用约束 公共错误码 & 业务错误码速查
    03 快速入门 快速入门 (全流程接入指南)
    04 域名管理 域名管理 (创建 / 查询 / 上下线 / 删除)
    05 域名配置 域名配置 (缓存 / 防盗链 / HTTPS / 回源)
    06 用量统计 用量统计 (计量带宽 / 流量 / 监控)
    07 运营统计 运营统计 (命中率 / 状态码 / UV / TopURL)
    08 缓存管理 缓存刷新 & 预取
    09 证书管理 SSL 证书管理
    10 日志下载 CDN 访问日志下载

    3. 接口模块分类

    3.1 域名管理

    接入域名: api.qiniu.com | 鉴权: Qiniu | 明细: 域名管理

    接口名称 请求方法 接口地址 核心功能
    创建域名 POST /domain/<Name> 新增普通 / 泛域名 CDN 加速配置
    创建泛子域名 POST /pandomain/<Name> 基于父泛域名创建子域名加速
    下线域名 POST /domain/<Name>/offline 暂停域名 CDN 加速服务
    上线域名 POST /domain/<Name>/online 恢复域名 CDN 加速服务
    删除域名 DELETE /domain/<Name> 注销域名 CDN 加速配置
    获取域名列表 GET /domain 分页查询账号下所有 CDN 域名
    获取域名信息 GET /domain/<Name> 查询单个域名的详细配置与状态

    注：为加速服务域名

    3.2 域名配置

    接入域名: api.qiniu.com | 鉴权: Qiniu | 明细: 域名配置

    接口名称 请求方法 接口地址 核心功能
    修改加速区域 PUT /domain/<Name>/geocover 调整域名加速区域（国内 / 海外 / 全球）
    修改源站配置 PUT /domain/<Name>/source 变更域名回源地址、类型、协议等
    修改 Range 回源 PUT /domain/<Name>/range 开启 / 关闭 Range 分片回源功能
    修改缓存规则 PUT /domain/<Name>/cache 调整文件 / 目录的缓存时长、忽略参数等
    修改响应头 PUT /domain/<Name>/respheader 配置 CDN 返回的 HTTP 响应头
    升级 HTTPS PUT /domain/<Name>/sslize 为域名开启 HTTPS 加速
    修改证书 PUT /domain/<Name>/httpsconf 更换域名 HTTPS 绑定的 SSL 证书
    配置 Referer 防盗链 PUT /domain/<Name>/referer 设置域名的 Referer 黑白名单防盗链
    配置 IP 黑白名单 PUT /domain/<Name>/ipacl 限制访问 CDN 的客户端 IP 范围
    配置时间戳防盗链 PUT /domain/<Name>/timeacl 开启域名时间戳 URL 防盗链
    配置回源鉴权 PUT /domain/<Name>/bsauth 配置 CDN 回源时的身份鉴权信息

    注：为加速服务域名

    3.3 用量统计

    接入域名: fusion.qiniuapi.com | 鉴权: QBox | 明细: 用量统计

    接口名称 请求方法 接口地址 核心功能
    计量带宽查询 POST /v2/tune/bandwidth 查询计量维度带宽数据，用于账单核对
    计量流量查询 POST /v2/tune/flux 查询计量维度流量数据，用于账单核对
    监控带宽查询 POST /v2/tune/monitoring/bandwidth 查询实时监控带宽数据，时效性优先
    监控流量查询 POST /v2/tune/monitoring/flow 查询实时监控流量数据，时效性优先

    3.4 运营统计

    接入域名: fusion.qiniuapi.com | 鉴权: QBox | 明细: 运营统计

    接口名称 请求方法 接口地址 核心功能
    缓存命中率统计 POST /v2/tune/loganalyze/hitmiss 查询 CDN 缓存的命中 / 未命中次数及流量
    HTTP 状态码统计 POST /v2/tune/loganalyze/statuscode 查询各 HTTP 状态码的访问次数
    请求次数统计 POST /v2/tune/loganalyze/reqcount 按区域查询 CDN 总请求次数
    UV 独立访客统计 POST /v2/tune/loganalyze/uniquevisitor 查询 CDN 独立访客数（UV）
    访问次数Top URL统计 POST /v2/tune/loganalyze/topcounturl 查询访问次数 TOP 的资源 URL
    访问流量Top URL统计 POST /v2/tune/loganalyze/toptrafficurl 查询访问流量 TOP 的资源 URL
    访问次数Top IP统计 POST /v2/tune/loganalyze/topcountip 查询访问次数 TOP 的客户端 IP
    访问流量Top IP统计 POST /v2/tune/loganalyze/toptrafficip 查询访问流量 TOP 的客户端 IP
    区域运营商流量统计 POST /v2/tune/loganalyze/traffic 按区域 / 运营商查询流量数据
    区域运营商带宽统计 POST /v2/tune/loganalyze/bandwidth 按区域 / 运营商查询带宽数据及峰值
    ISP 请求次数统计 POST /v2/tune/loganalyze/ispreqcount 按运营商查询 CDN 请求次数
    ISP 流量占比统计 POST /v2/tune/loganalyze/isptraffic 查询各运营商的流量占比情况

    3.5 缓存刷新 & 预取

    接入域名: fusion.qiniuapi.com | 鉴权: QBox | 明细: 缓存管理

    接口名称 请求方法 接口地址 核心功能
    缓存刷新 POST /v2/tune/refresh 刷新 CDN 节点上的文件 / 目录缓存
    刷新查询 POST /v2/tune/refresh/list 查询缓存刷新任务的执行状态
    资源预取 POST /v2/tune/prefetch 将源站新资源预取到 CDN 节点
    预取查询 POST /v2/tune/prefetch/list 查询资源预取任务的执行状态

    3.6 SSL 证书管理

    接入域名: fusion.qiniuapi.com | 鉴权: QBox | 明细: 证书管理

    接口名称 请求方法 接口地址 核心功能
    上传证书 POST /sslcert 上传 SSL 证书，用于域名 HTTPS 配置
    删除证书 DELETE /sslcert/<CertID> 删除账号下未绑定的 SSL 证书
    获取证书 GET /sslcert/<CertID> 查询单个 SSL 证书的详细信息
    获取证书列表 GET /sslcert?marker=<Marker>&limit=<Limit> 分页查询账号下所有 SSL 证书

    3.7 CDN 日志下载

    接入域名: fusion.qiniuapi.com | 鉴权: QBox | 明细: 日志下载

    接口名称 请求方法 接口地址 核心功能
    日志下载 POST /v2/tune/log/list 申请并获取 CDN 访问日志的下载链接

    4. 核心约束

    约束项 说明
    请求域名 域名管理/配置 → api.qiniu.com，其余 → fusion.qiniuapi.com
    鉴权方式 api → Qiniu AK:Sign，fusion → QBox access_token，不可混用
    请求格式 请求体均为紧凑 JSON，Header 必须携带 Content-Type: application/json
    幂等性 GET/DELETE/PUT 幂等，POST 部分非幂等 (创建/刷新/预取)
    QPS 限制 api 10 QPS，fusion 5-10 QPS，超限返回 403024
    生效时间 域名配置 5-10 分钟，刷新 5-10 分钟，预取 10-20 分钟
    参数差异 用量统计 domains=string(分号分隔)，运营统计 domains=array
    日志保留 仅 30 天内，仅支持单日查询
    统计数据保留 计量 180 天 / 监控 90 天 / 运营 90 天
    时间统计跨度 用量统计跨度 ≤ 31 天，运营统计跨度 ≤ 30 天
    以上内容是否对您有帮助？