文档完整,只能证明“写了什么”
字段、示例、鉴权方式和错误码都写在文档里,并不代表目标环境已经部署同一版本,也不代表测试账号拥有需要的权限。可靠联调首先记录文档来源、版本、目标环境和允许执行的请求边界。
HTTP 200 不是契约通过
成功状态码后仍要检查响应媒体类型、字段是否存在、类型是否一致、示例约束、分页、空值和错误结构。网关返回成功、业务数据为空或字段悄悄漂移,都可能让调用方在真实流程中失败。
验证需要权限与停止边界
公开文档提取与真实网络请求不是同一风险。真实验证应只访问用户明确授权的端点,优先使用 GET 或 HEAD 等有边界请求,不猜测凭据、不扩大到生产写操作,也不把令牌和完整生产响应写入报告。
API Contract Verifier 当前做到了什么
公开版本 1.0.0 可以从 Markdown、HTML、PDF 和 OpenAPI JSON 中提取契约,在授权后执行有限 GET/HEAD 请求,并把结果区分为 PASS、WARNING、ERROR 和 BLOCKED。公开详情页同时给出版本、权限、限制、验证环境、许可证、ZIP 大小和 SHA-256。
它没有承诺什么
它不保证验证任何第三方 API,不替代安全测试,也不会自动获取凭据或修改服务端。公开验证使用隔离环境和本地回环服务,不等于已经验证每个客户生产系统。下载前可以先检查完整证据与权限,再决定是否安装。