Postman 集合维护工作流

概述

共享集合若内嵌密钥就可能随导出而泄露，且手工维护会与 API 逐渐脱节。由契约生成集合、把密钥与环境值放入环境变量、为关键请求添加断言、并在 CI 中针对预发运行以发现漂移，可让集合长期可用且安全。

关键步骤

1. 由 OpenAPI 契约生成或更新集合。
2. 把密钥与环境值保留在环境变量中。
3. 为关键请求添加测试与断言。
4. 在 CI 中针对预发运行集合。

验证

• 集合不含任何密钥取值。
• CI 运行针对当前预发构建通过。
• 集合与 API 一致。
• 集合有版本与契约修订记录。

决策点

密钥必须放在环境变量而非共享集合的变量中，后者易随导出泄露；集合应生成以避免漂移。

适用范围

本条目围绕「Postman 集合维护工作流」给出可复制的步骤、验证方式与常见问题，适合需要按此流程落地的工程团队。执行时请结合自身上下文调整命令与阈值，并在变更前后留存证据，便于后续复核与回滚。

建议在正式环境落地前先在预发或隔离环境演练一遍，把关键观测指标与负责人一并记录，确保出现异常时能快速定位并恢复。

{
  "info": { "name": "Orders API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" },
  "variable": [
    { "key": "baseUrl", "value": "{{baseUrl}}" }
  ]
}