合作伙伴 API
合作伙伴 API
面向合作伙伴的服务器 API：通过您自己的网站或机器人创建客户、发放套餐并管理订阅。
合作伙伴 API 让您可以在 CreateYourVPN 之上构建自己的网站、客户门户或机器人。API 只公开客户、套餐和订阅；服务器、节点、面板以及基础设施凭据绝不会出现在响应中。
密钥仅供服务器之间通信使用。 切勿将其放入 JavaScript 或移动应用。看起来来自浏览器的请求会以 403 browser_forbidden 拒绝。
开始使用
- 在控制面板中打开 设置 → API 和集成。
- 使用最小权限创建密钥并复制 secret；它只显示一次。
- 通过
Authorization: Bearer cyv_live_…或X-API-Key发送密钥。
curl https://api.createyourvpn.com/api/v1/partner-api/me \
-H "Authorization: Bearer cyv_live_<key_id>_<secret>"权限：config:read 用于配置和地区，users:read 用于读取客户，users:write 用于创建客户和管理订阅。
公开契约
公开 Postman 集合包含所有端点、参数、请求体、示例、权限和错误代码。它由后端契约生成，因此是唯一的技术参考。
限制：每个密钥每分钟 120 个请求，GET /users 每分钟 10 个请求。grant、rotate 和 DELETE 必须提供 Idempotency-Key；同一事件的所有重试应在 24 小时内复用相同值。