外观
API 概览
昆腾 CDN 开放 API 用于把账户、套餐、网站和缓存任务接入脚本、发布系统或内部面板。API 采用 HTTPS + JSON，所有接口都要求客户 API 密钥。
基础信息
text
Base URL: https://cdn.1888.news/api/open/v1
Content-Type: application/json请求流程：
- 在控制台“开发者服务 → API 接入”申请密钥。
- 把密钥保存在服务端密钥管理系统，不要写进前端代码或 Git 仓库。
- 每次请求带
Authorization: Bearer 你的API密钥，也支持X-API-Key。 - 根据响应中的
code、HTTP 状态码和requestId处理结果。
接口清单
| 方法 | 路径 | 用途 |
|---|---|---|
| GET | / | 查看 API 版本、认证方式和开放资源范围 |
| GET | /account | 查询当前 API 账号、余额和累计充值 |
| GET | /packages | 查询当前账号套餐及配额 |
| GET | /catalog | 查询可见的套餐分类、套餐和升级包 |
| GET | /packages/:id | 查询单个客户套餐 |
| GET | /packages/:id/usage | 查询套餐用量 |
| GET | /packages/:id/upgrades | 查询该套餐可用升级项 |
| GET | /sites | 查询当前账号网站列表，支持分页和搜索 |
| GET | /sites/:id | 查询单个网站 |
| POST | /sites | 创建网站并绑定套餐 |
| PATCH | /sites/:id/origin | 修改源站、回源协议和端口 |
| PATCH | /sites/:id/status | 启用或停用网站 |
| DELETE | /sites/:id | 删除网站，要求域名二次确认 |
| POST | /cache/tasks | 提交刷新、目录刷新或预热任务 |
| GET | /cache/tasks | 查询当前账号的缓存任务 |
| GET | /orders、/orders/:id | 查询自己的订单 |
| GET | /api-key | 查看当前密钥的安全摘要，不返回完整明文 |
网站详情还提供按配置分区更新的接口：
text
PATCH /sites/:id/config/basic
PATCH /sites/:id/config/origin
PATCH /sites/:id/config/https
PATCH /sites/:id/config/security
PATCH /sites/:id/config/cache
PATCH /sites/:id/config/access
PATCH /sites/:id/config/advanced配置接口只接受对应分区的字段，不支持用开放 API 修改管理员配置。数据接口包括 /sites/:id/analytics、/sites/:id/realtime、/sites/:id/rankings、/sites/:id/access-logs 和 /sites/:id/blacklist-logs；它们同样只返回当前账号拥有的网站数据。
如果需要操作证书、DNS-API、ACL、CC 规则、流媒体或其他客户资源，可使用白名单内的 /resources/:kind 或文档页面中的友好别名。接口只允许客户资源类型，不接受任意上游路径拼接。
API 只允许操作当前客户账号拥有的资源。管理员账号不能用客户开放 API 代替管理后台权限。
生产调用建议
所有写操作都应记录业务订单号或发布批次号，并在客户端实现超时、重试和幂等保护。收到 429 时遵守 Retry-After，不要立即高频重试。
下一步：阅读 认证与密钥，上线前再对照 API 生产接入清单。
需要逐项核对开放范围时，直接查看客户开放 API 接口矩阵。