CVPN API 文档

机器可读的完整契约：OpenAPI 3.1 YAML

健康检查

• GET /health/live
• GET /health/ready

管理接口

• GET /admin/v1/dashboard 分页运维快照
• POST /admin/v1/enrollment-tokens 创建一次性节点注册令牌
• GET/PUT/DELETE /admin/v1/nodes 查询、编辑与安全撤销节点
• GET /admin/v1/certificates 分页读取主控源站与节点证书生命周期
• GET/POST/PUT/DELETE /admin/v1/partner-keys 管理销售平台凭据及安全轮换
• GET/POST /admin/v1/commercial-services 商业服务、设备详情与紧急暂停/恢复
• GET /admin/v1/usage-events 顺序读取计费事件
• GET /admin/v1/network-audit 按会话、访问目标或出口连接直接查询；域名会兼容匹配 VPN 出口位置的当前解析 IP，解析 IP 命中会标注需复核；查询操作自动留痕

销售平台接口

• POST /partner/v1/services 幂等创建商业服务
• GET /partner/v1/services/{service_id} 查询权益与账期用量
• POST /partner/v1/services/{service_id}/{action} 激活、暂停、恢复或终止
• POST /partner/v1/services/{service_id}/change-plan 变更套餐权益
• POST /partner/v1/services/{service_id}/renew 设置绝对账期
• GET/POST/DELETE /partner/v1/services/{service_id}/devices 客户设备与节点配置
• POST /partner/v1/reconciliation 批量对账

节点接口

• POST /agent/v2/enroll 一次性注册
• POST /agent/v2/heartbeat 签名心跳
• GET /agent/v2/desired-state 获取主控签名状态
• POST /agent/v2/usage-events 上报计量
• POST /agent/v2/audit-events 上报受控审计事件

Admin 写操作使用账户会话与 CSRF；Partner 写操作使用带权限和 IP 白名单的 Token 与 Idempotency-Key；Agent v2 使用 Ed25519 签名。字段、分页参数、错误码和请求示例以 OpenAPI 契约为准。

返回主控状态页