接口与安全
OpenAPI / GraphQL / Postman 工具
维护接口文档最烦的是规范和实际接口对不上、团队里一半人用 Postman 一半人要 OpenAPI、又或者升级了一版 GraphQL schema 却不确定会不会破坏现有查询。OpenAPI 编辑器编辑与验证规范,OpenAPI 差异对比比较两个版本之间的差异,OpenAPI Mock 数据生成从规范生成模拟数据,方便前端先联调。
两个生态之间转换用 Postman 转 OpenAPI,把集合转成 OpenAPI 规范,也能反向生成集合。GraphQL 这边,GraphQL 文档工作台编辑与测试 schema,GraphQL Schema 对比比较 schema 差异,方便合并前确认哪些字段被改动。需要把接口调用转成代码时,cURL 转换器能把命令转成多种语言的请求代码。
7 个工具
全部OpenAPI / GraphQL / Postman工具
OpenAPI / GraphQL / Postman工具常见问题
怎么确认新版本 OpenAPI 规范改了哪些接口?
用 OpenAPI 差异对比,把新旧两份规范文件都传进去,它会比较两个 API 版本之间的差异内容并列出改动,比人工逐条对照两份 YAML 或 JSON 文件要快得多,适合在发布前确认这次改动是否会影响到现有客户端。
前端还没等到后端接口就绪,怎么先联调?
用 OpenAPI Mock 数据生成,从已经定好的 OpenAPI 规范里直接生成符合结构的模拟数据,前端可以先按这份数据把界面和交互跑通,等真实接口上线后再切换过去,不用等后端开发完成才能开始联调工作。
只有 Postman 集合没有 OpenAPI 文档,能互相转换吗?
可以,用 Postman 转 OpenAPI 把已有的 Postman 集合转成 OpenAPI 规范文档,方便生成给其他团队或工具使用的标准接口文档;如果反过来只有 OpenAPI 规范,也能用它生成对应的 Postman 集合,导入 Postman 直接测试接口。