CDN

    • CDN > API 文档 > API列表

    API列表

    最近更新时间: 2026-09-03 10:24:49

    1. 域名与鉴权绑定规范

    接入域名鉴权方式QPS覆盖模块
    api.qiniu.comQiniu (请求内容签名)10域名管理、域名配置
    fusion.qiniuapi.comQBox (路径签名)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>查询单个域名的详细配置与状态

    注：Name为加速服务域名

    3.2 域名配置

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

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

    注：Name为加速服务域名

    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 证书

    注：certId为证书ID

    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 POST、PUT请求使用Content-Type:application/json；GET、DELETE请求使用Content-Type:application/x-www-form-urlencoded 或不追加
    幂等性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 天
    以上内容是否对您有帮助？