开发者
API 已经存在,只是公开的参考文档暂时还没有。
本平台的一切(商店、购物车、控制面板)都已通过同一个 API 通信。我们尚未做的是将其公开:目前没有面向客户的令牌,也没有参考文档。我们宁愿如实说明,也不愿拿一张截图向您推销。
公开 API:计划中,请在下方登记意向
目前
目前真实的情况。
商店前台和控制面板已经运行在我们自己的内部 API 上。将其公开意味着需要文档、令牌发放机制以及我们能够兑现的稳定性承诺,而这些目前都还没有。
尚不存在的内容:可自行创建的 API 密钥、附带数据结构的公开参考文档,以及让 API 值得投入开发的稳定性承诺。在我们能够以书面形式确定版本和弃用政策之前,我们不会发放令牌:一个在您使用过程中随时变化的 API,比没有 API 更糟。
如果您的工作流程目前就需要以编程方式开通服务器,请通过咨询表单告诉我们您在构建什么。大家的需求确实会影响我们的开发顺序,抢先体验也将从提出需求的用户开始。
计划提供的接口
公开 API 将涵盖的内容。
以下是内部 API 已具备、公开 API 将会开放的功能。计划中就是计划中:目前客户无法调用其中任何一项。
- 服务器生命周期
- 通过您自己的代码创建、重装、重启和删除服务器:即控制面板目前可执行的操作。
- 实时目录
- 以数据形式提供套餐、区域和系统镜像,价格与商店显示的一致,适用时包含您的合作伙伴折扣。
- 域名和 DNS
- 通过与本站相同的注册商集成进行搜索、注册和管理记录。
- 用量与计费
- 可通过程序读取的逐小时计量数据:即您向自己的客户转售计费所需的数据。
- 使用 Webhook,而非轮询
- 生命周期事件经签名后推送到您的端点,让您的系统直接响应,而无需轮询。
- 限定范围的令牌
- 只读、仅开通或完全访问权限的密钥,可随时立即撤销,并提供按令牌划分的审计日志。
我们遵循的设计原则:标准的 REST 接口和含义明确的状态码,变更类调用支持幂等键,创建时支持 cloud-init user_data,在响应头中注明速率限制,错误信息会告诉您下一步该做什么。刻意保持朴素。