跳至正文

开发者

API 已经存在,只是公开的参考文档暂时还没有。

本平台的一切(商店、购物车、控制面板)都已通过同一个 API 通信。我们尚未做的是将其公开:目前没有面向客户的令牌,也没有参考文档。我们宁愿如实说明,也不愿拿一张截图向您推销。

公开 API:计划中,请在下方登记意向
一台被划分为多个虚拟服务器的宿主机示意图,其中一台被突出显示API 已存在参考信息:暂未提供

目前

目前真实的情况。

商店前台和控制面板已经运行在我们自己的内部 API 上。将其公开意味着需要文档、令牌发放机制以及我们能够兑现的稳定性承诺,而这些目前都还没有。

尚不存在的内容:可自行创建的 API 密钥、附带数据结构的公开参考文档,以及让 API 值得投入开发的稳定性承诺。在我们能够以书面形式确定版本和弃用政策之前,我们不会发放令牌:一个在您使用过程中随时变化的 API,比没有 API 更糟。

如果您的工作流程目前就需要以编程方式开通服务器,请通过咨询表单告诉我们您在构建什么。大家的需求确实会影响我们的开发顺序,抢先体验也将从提出需求的用户开始。

计划提供的接口

公开 API 将涵盖的内容。

以下是内部 API 已具备、公开 API 将会开放的功能。计划中就是计划中:目前客户无法调用其中任何一项。

服务器生命周期
通过您自己的代码创建、重装、重启和删除服务器:即控制面板目前可执行的操作。
实时目录
以数据形式提供套餐、区域和系统镜像,价格与商店显示的一致,适用时包含您的合作伙伴折扣。
域名和 DNS
通过与本站相同的注册商集成进行搜索、注册和管理记录。
用量与计费
可通过程序读取的逐小时计量数据:即您向自己的客户转售计费所需的数据。
使用 Webhook,而非轮询
生命周期事件经签名后推送到您的端点,让您的系统直接响应,而无需轮询。
限定范围的令牌
只读、仅开通或完全访问权限的密钥,可随时立即撤销,并提供按令牌划分的审计日志。

我们遵循的设计原则:标准的 REST 接口和含义明确的状态码,变更类调用支持幂等键,创建时支持 cloud-init user_data,在响应头中注明速率限制,错误信息会告诉您下一步该做什么。刻意保持朴素。

登记意向

告诉我们您会用它构建什么。

简单描述一下您的使用场景即可。当有真正可以试用的内容时,我们会联系您,而不是向您持续群发营销邮件。