Elysia Tools
导航
Development
对比 OpenAPI 或 GraphQL schema，标记 breaking changes，并生成面向 API 团队的影响报告
执行
填写表单、运行工具，并在同一页面查看结果。
案例
相关内容
等待运行
工具使用指南
OpenAPI 变更破坏检测器是一款专为 API 团队设计的 Schema 对比工具。通过输入新旧版本的 OpenAPI 或 GraphQL 契约文件，工具能自动识别并标记出可能导致客户端崩溃的破坏性变更（Breaking Changes），如删除响应字段或新增必填参数，并生成结构化的影响分析报告，帮助开发者在发布前拦截潜在风险，保障接口的向下兼容性。
背景
团队正在重构用户服务，清理了一些被认为不再使用的旧字段，准备发布新版本。
问题
需要确认重构后的 OpenAPI 规范是否意外移除了前端仍在使用的响应字段，导致线上故障。
如何使用
将旧版和新版的 OpenAPI YAML 分别粘贴到旧 Schema 和新 Schema 输入框中，选择 openapi 类型并开启影响分析。
{
"schemaType": "openapi",
"includeImpactAnalysis": true
}结果
工具检测到 200 响应中 email 字段被移除，标记为破坏性变更（Breaking Change），并提示发布风险为高（high），成功在上线前拦截了该问题。
背景
后端团队更新了 GraphQL Schema，在创建文章的 Mutation 中增加了一个分类字段。
问题
需要评估这个新字段是否会破坏现有的前端请求逻辑。
如何使用
将更新前后的 GraphQL SDL 粘贴到对比框中，选择 graphql 类型进行检测。
{
"schemaType": "graphql",
"includeImpactAnalysis": true
}结果
报告明确指出 CreatePostInput 中新增了必填字段 category，属于破坏性变更，提醒前端团队必须在发版前同步更新 Mutation 传参。
支持 OpenAPI (Swagger) 的 YAML 或 JSON 格式，以及 GraphQL 的 SDL (Schema Definition Language) 格式。
指可能导致现有客户端请求失败的修改，例如删除已有的响应字段、修改字段类型或在请求体中新增必填参数。
可以。在“Schema 类型”选项中选择“Auto detect”，工具会根据输入内容自动识别是 OpenAPI 还是 GraphQL。
报告包含整体发布风险评估（如 high）、变更总数统计，以及具体的变更路径、变更类型和对客户端的潜在影响说明。
安全的。所有的 Schema 解析和对比均在处理时即时完成，工具不会永久存储您的 API 规范内容。