采用语义化版本控制。破坏性变更(字段重命名、端点移除、认证方案变更)仅在带有新 URL 前缀 /v2/ 的新主版本中出现。在 /v1/ 内仅进行增量变更(新增可选字段、新增端点)。
v1.4.0 (2026-11-09)
- 新增路由 GET /v1/services/{id}/metrics(read:services 权限):提供 1h、6h、24h、7d 和 14d 时间范围的服务器指标。Edge Unlimited Traffic VPS 提供 CPU、内存、网络和出站流量数据;常规 Unlimited Traffic VPS 在端点参考中列出的站点提供入站和出站网络数据。
- 新增路由 GET /v1/services/{id}/ddos/attacks 和 GET /v1/services/{id}/ddos/attacks/{attack_id}(read:ddos 权限):提供 Remote DDoS Protection 最长 90 天的攻击报告,包括流量曲线以及按协议、端口、来源和数据包大小的分项统计。
- 防护配置和规则(/ddos/profiles、/ddos/rules 及写入操作):若服务属于您的账户但不是 Advanced DDoS Protection 服务,现在返回 HTTP 409 not_supported_for_product,而不再返回 HTTP 404。未知或不属于您的服务 ID 仍返回 HTTP 404。
v1.3.1 (2026-11-02)
- 德国和法国可以分别选择:“德国(欧洲)”仅在德国法兰克福部署,“法国(欧洲)”仅在法国部署。
- 常规 Unlimited Traffic VPS 在欧洲、德国、法国、加拿大东部、英国和波兰站点的交付可能需要最多 7 天。大多数情况下,服务器会在 48 小时内准备就绪。计费周期仅从您收到服务器时开始。
v1.3.0 (2026-11-02)
- Advanced DDoS Protection 新增四项路由,支持读取防护配置和规则、添加规则以及删除自有规则。请明确启用 read:ddos 和 write:ddos;现有密钥不会获得新权限。
- 面板与 API 共用限制、顺序执行修改,并要求 POST 和 DELETE 提供 Idempotency-Key,以防止规则滥发和并发请求绕过限制。
v1.2.2 (2026-10-27)
- POST /v1/orders:如果已付款的服务无法立即开通,其 ID 现在列在 awaiting_setup 字段中(status 为 awaiting_setup),不再列在 provisioning_failures 中(status 为 partial)。该服务会在条件允许时自动开通,随后状态变为 active。在这种情况下,请勿重复下单。
v1.2.1 (2026-10-26)
- Dedicated Unlimited Traffic VPN:新增欧洲、美洲、亚洲、中东、非洲和澳大利亚的加价位置。GET /v1/products/{id} 会列出这些位置的显示名称和加价。如果此类位置当前已售罄,POST /v1/orders 返回 HTTP 409 location_sold_out。未指定位置时,仍采用列表中的第一个位置(Europe)。
- Dedicated Unlimited Traffic VPN 和 Dedicated High Speed Unlimited Traffic VPN 套餐的可配置选项(位置和操作系统)及其子选项均已使用新的 ID。请通过 GET /v1/products/{id} 读取 ID;硬编码的旧 ID 将返回 HTTP 400 validation_failed。对于这两种套餐中在此变更之前 status 已为 cancelled、terminated 或 fraud 的服务,GET /v1/services/{id} 返回的 location 为 null。High Speed VPN 现在仅可通过以下位置选项订购:「Europe」、「Germany or France」、「Canada East (Beauharnois)」、「France (Europe)」、「United Kingdom (Europe)」和「Poland (Europe)」。
- Edge Unlimited Traffic VPS:新增六个位置(美因河畔法兰克福、伦敦、切斯特、巴黎、华沙和华盛顿特区),共计最多 25 个。新位置有各自的 sub_option_id,原有位置的 ID 保持不变。部分套餐的基础价格与位置加价重新分配,原有位置的总价保持不变。请始终通过 GET /v1/products/{id} 读取 ID 和价格。
v1.2.0 (2026-10-24)
- POST /v1/orders:对于可选择位置的产品(Edge Unlimited Traffic VPS),位置选项没有默认值,必须在 config_options 中提交,否则返回 HTTP 422,reason 为 location_required。已售罄的位置返回 HTTP 409 location_sold_out。新增的可选字段 storage_gb 用于设定总存储容量,范围为 20 至 300 GB。套餐价格已包含 20 GB,未提交该字段时即采用此容量;每增加 1 GB 按 GET /v1/products/{id} 中列出的价格计费。其他值返回 HTTP 422 storage_out_of_range。
- 对于这些产品,订单结果包含 location 和 storage_gb(以 GB 计的总存储容量),GET /v1/products/{id} 在 storage 字段中说明存储容量范围以及每增加 1 GB 的价格。GET /v1/services 和 GET /v1/services/{id} 为每项服务返回 location 和 storage_gb(若产品没有此类选择则为 null)。
- GET /v1/products/{id} 现在只返回子选项的显示名称(例如「Finland (Europe)」),不再包含其前面的内部值。POST /v1/orders 会以 HTTP 409 out_of_stock 拒绝当前已售罄的产品。
v1.1.0 (2026-09-23)
- POST /v1/orders:config_options 仅接受商店中可见的选项和取值,数量必须在其限制范围内。未指定的可见选项将采用列表中的第一个值,与商店完全一致。GET /v1/products/{id} 仅列出可订购的选项,并返回 quantity.min 和 quantity.max。
- 新增订单状态 awaiting_setup 及字段 awaiting_setup,适用于由 KernelHost 团队手动开通的产品。自动开通的服务只会开通一次。
- 请求 body 限制为 64 KB(HTTP 413)。每个账户在所有密钥之间共享每分钟 120 次请求的限额,每个账户最多可持有 20 个有效密钥。认证失败不再锁定任何密钥,Idempotency-Key 与请求方法和路径绑定。
- 包含多个查询参数的请求(例如 GET /v1/services?limit=10&offset=0)此前会以 HTTP 401 被拒绝。现在签名严格按照文档说明覆盖查询字符串。
v1.0.0 (2026-05-14)
- 首次发布。包含全部 15 个端点、HMAC 身份验证、AES-GCM 密钥存储、速率限制、幂等性、审计日志。
- GET
/v1/me,/v1/products,/v1/products/{id} - POST
/v1/orders, GET/v1/orders/{id} - GET
/v1/services,/v1/services/{id},/v1/services/{id}/credentials - POST
/v1/services/{id}/actions - GET
/v1/billing/balance,/v1/billing/invoices,/v1/billing/invoices/{id}/pdf - GET/PUT
/v1/webhooks - HMAC-SHA256 signing, AES-256-GCM secret storage, replay protection, idempotency.

