Skip to main content

要求

与 v4 相同:Node.js 20.0.0 或更新版本,同时支持 ESM 和 CJS。

破坏性变更概览

client.users 被移除

与 v3 到 v4 的迁移不同,这次没有已弃用的代理。client.users 已不再存在,调用它会抛出异常。

Backups 被移除

app.backupapp.backups 已被移除,Backup 导出也一并移除。对于应用和数据库,snapshot 是唯一受支持的方案。
对应用 snapshot 使用 Snapshot 类,对数据库 snapshot 使用 DatabaseSnapshot 类。

api.applications.create(file) 返回结构

创建应用现在会返回更丰富的语言与资源数据,而不再是扁平的 lang/ram 组合。

app.network.dns() 结构

dns() 现在返回一个由 DNS 记录组成的数组,而不再是单一的 { ownership, ssl } 对象。
txt 记录同时涵盖所有权验证和 SSL 验证,cname 记录则是流量记录。status 反映验证状态(pendingpending_validationactive 等)。

其他变化

  • ApplicationLanguage 现在包含 ruby,与 javascript、typescript、python、java、elixir、go、rust、php、dotnet 和 static 并列。
  • 错误代码已标准化。新名称通过 APIErrorCode 导出;旧名称仍作为已弃用的类型别名保留。完整的重命名对照表参见错误代码