SheepNav
DriftMap

DriftMap

driftmap.io

从JSON样本推断API契约,拦截破坏性PR

2天前制作者:Nawaz Bin Younus

关于 DriftMap

DriftMap 是一款专注于 API 契约安全的开发者工具,它能在代码合并前捕捉 JSON 负载和 OpenAPI 规范的破坏性变更。通过从原始 JSON 样本中自动推断实时 API 契约,DriftMap 帮助团队在开发早期发现潜在风险。

核心功能

DriftMap 提供了一个零上传的 IndexedDB 工作台,你只需粘贴 JSON 样本,即可快速生成契约模型。它会将变更智能分类为四个风险等级:BREAKING(破坏性)、WARNING(警告)、SAFE(安全)和 INFO(信息),让团队对每次修改的影响一目了然。

主要特性

  • 零上传隐私保护:所有数据处理均在浏览器本地完成,无需上传敏感数据,确保安全合规。
  • 智能风险分级:自动将 API 变更分为四个风险等级,优先处理破坏性变更,减少误报干扰。
  • GitHub Actions 集成:在 PR 流程中自动运行契约检查,通过粘性差异报告直观展示变更详情,并支持云基线同步,确保团队始终基于最新契约协作。
  • OpenAPI 支持:除了 JSON 样本,还能直接分析 OpenAPI 规范文件,覆盖更广泛的 API 场景。

适用场景

DriftMap 非常适合需要频繁迭代 API 的研发团队,尤其是在微服务架构下,它能有效防止因契约变更导致的上下游服务故障。无论是前端与后端联调,还是第三方 API 集成,DriftMap 都能成为 API 质量保障的关键一环。

相关工具