4. 接口调试工具介绍：Postman、Insomnia、cURL 的安装与基本使用

在供应链计划系统的接口调试与实时同步实施中，选择合适的调试工具直接影响问题定位效率与团队协作质量。本节将系统介绍三款主流工具——Postman、Insomnia 与 cURL 的安装流程、核心操作，并基于供应链场景（如 EDI 报文验证、库存 API 压测、采购订单实时同步）进行优劣对比。

4.1 工具安装与环境准备

4.2 基本使用：以供应链采购订单查询接口为例

假设供应链计划系统暴露了一个 GET /api/v1/purchase-orders/{orderId} 接口，返回 JSON 格式的订单详情。以下分别演示三款工具的操作步骤。

4.2.1 Postman 操作流程

1. 打开 Postman，点击 New → HTTP Request。
2. 选择方法为 GET，输入 URL：https://scm.example.com/api/v1/purchase-orders/PO-2025-001。
3. 在 Headers 标签页添加 Authorization: Bearer <> 与 Content-Type: application/json。
4. 点击 Send，查看响应状态码、响应体与响应时间。
5. 将请求保存到集合，并设置环境变量 {{base_url}} 实现多环境切换。

4.2.2 Insomnia 操作流程

1. 启动 Insomnia，点击 Create → Request Collection。
2. 新建请求，选择 GET，输入 URL 与 Headers（同上）。
3. Insomnia 自动格式化 JSON 响应，支持 预览 与 原始 视图切换。
4. 使用 Environment 面板定义 base_url 与 变量。

4.2.3 cURL 命令行操作

curl -X GET "https://scm.example.com/api/v1/purchase-orders/PO-2025-001" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -w "\nHTTP Status: %{http_code}\nResponse Time: %{time_total}s\n"

4.3 供应链场景下的优劣对比

4.4 工具协同工作流（SVG 架构图）

4.5 供应链接口调试实战要点

• 环境变量隔离： 在 Postman 中为开发、测试、预发布、生产分别创建环境，避免 URL 与 混淆。
• 断言自动化： 使用 Postman 的 pm.test() 或 Insomnia 的 Response Validation 插件，自动校验响应结构是否符合供应链数据标准（如 JSON Schema）。
• cURL 脚本化： 将 cURL 命令封装为 shell 函数，配合 jq 解析 JSON 响应，实现批量订单状态查询。
• 日志记录： 在 Insomnia 中启用 Network Log，在 Postman 中使用 Console 面板，追踪请求/响应详情。