用途：为 Fly.io Machines REST API 构建一个带类型的本地适配器。资料明确说明 Fly.io 发布 REST API 与 OpenAPI 参考，但该工作流不声称存在提供方维护的 JavaScript SDK，因此只应生成或手写轻量本地适配器，保留提供方字段可见，并集中处理鉴权、超时、限制、状态等待与脱敏。
主要能力与使用方式：先冻结契约，记录基础 URL、操作路径、请求与响应模式、状态枚举、响应码与检索指纹，保留未知字段以向前兼容；再定义精简传输层，集中 bearer 鉴权、内容类型、请求 ID、超时、重试资格、响应解析与错误脱敏，不隐藏目标应用或 Machine 标识；将期望状态与观测状态分开建模，区分 Machine ID、实例版本、配置、生命周期状态与目标状态，要求调用方先协调再重放；变更后使用提供方的等待操作，在有限超时内等待 started、stopped、suspended 或 destroyed，必要时带实例版本。限流与冲突方面，按标识符串行化冲突操作，使用文档化的每操作限制，仅在符合条件时重试，遇 409、408 或传输结果不明确时刷新状态。测试上用夹具覆盖每类响应与错误，再执行授权的读操作和一次可回滚的非生产生命周期操作并清理。鉴权上从密钥管理器注入 FLY_API_TOKEN，仅以 bearer 头发送到文档化的 Machines API 主机，令牌作用域不写入客户端配置文件，异常中清除头与 Machine 配置密钥。
适用场景：需要以带类型适配器调用 Machines API 的 TypeScript 或其他运行时代码，并要求契约指纹、操作矩阵与测试凭据。
限制：不得在无明确操作者批准时创建、部署、扩缩、重启、停止、挂起、销毁、轮换、撤销、暴露或迁移线上 Fly.io 资源。资料未提供具体价格、收费或平台效果信息。