简介
流行的 API 客户端，支持请求调试、集合、环境变量与协作。
下列说明侧重开发者如何在本站 API 目录选型后，用该工具完成联调与文档协作；具体功能与版本以官方产品为准。
类型
API 测试 / 调试
相关链接
能做什么
Postman 可发送 REST/GraphQL 请求、组织 Collection、用环境变量切换 dev/staging/prod、编写前置/后置脚本做断言，并与团队共享集合或生成文档。
典型工作流
- 导入 OpenAPI 或 cURL 生成初始请求
- 配置 Authorization（Bearer、API Key 等）
- 保存示例响应作为 Mock 或测试基线
- 通过 Runner/CLI 做回归或 CI 冒烟
何时用
接口联调、与后端对齐契约、向非开发同事演示 API、或需要协作维护大量端点时。单人偶发调试可用更轻工具，但 Postman 在团队场景更省心。
注意点
勿把生产 Secret 同步到公共 Workspace；定期清理历史记录中的 Key；脚本里避免硬编码密码。Monitors 与 Mock 有配额，阅读当前定价。
与 API 目录配合
在极旺 API 导航选定接口后，把官方文档中的示例 URL 与 Header 录入 Collection，并命名环境变量如 baseUrl、apiKey。联调通过后导出文档链接给测试同学，减少口头传递造成的参数遗漏。
团队实践
为每个外部 API 维护一条「黄金请求」用例，版本升级后先跑 Runner。失败时对比响应 diff，比从零猜参数更快定位是文档变更还是环境 Key 过期。新成员入职先看 Collection 注释字段，比口头讲解更不易遗漏 Header。