开放 API

用程序完成控制台里的大部分操作:读取账户与站点信息、修改站点配置、刷新缓存、拉取流量与防护数据。全部是 HTTPS + JSON,用一枚 API 密钥认证。

基本信息

接口地址https://cdn.treeidc.cn
协议HTTPS(强制)
编码UTF-8;带 body 的请求用 Content-Type: application/json
响应JSON,顶层恒有 ok 字段
认证请求头 Authorization: Bearer <API 密钥>

三步跑通

1. 拿到密钥

登录控制台 → 左侧「API 密钥」→ 复制。密钥是 64 位十六进制字符串。

2. 发第一个请求

curl -H "Authorization: Bearer 你的API密钥" \
     https://cdn.treeidc.cn/api/me

3. 看到自己的账号信息就算通了

{
  "ok": true,
  "user": {
    "id": 2,
    "username": "your-account",
    "role": "client",
    "must_change_password": false,
    "last_login_at": "2026-08-30T19:31:49.890Z",
    "last_ip": "203.0.113.10",
    "last_location": "中国 湖南省 移动",
    "created_at": "2026-06-19T12:00:00.000Z"
  }
}

返回 401 说明密钥没生效 —— 先看认证那一页。

能做什么

功能典型用法
账户信息校验密钥、读余额与资源计数
站点管理批量建站、改回源地址、启停站点
缓存刷新发版后自动刷新静态资源
流量与统计把带宽/流量接进自己的监控大盘
安全防护日志拉取拦截记录做告警与取证
套餐与订单监控剩余流量与到期时间