核心工作流

组织接口集合

1. 按系统或项目创建集合。
2. 按业务域或服务划分文件夹。
3. 为请求补充说明、文档备注和响应示例。
4. 使用搜索、复制和移动整理长期维护的接口资产。

导入 OpenAPI

通过顶部 OpenAPI 入口导入 OpenAPI 3.x JSON 或 YAML。导入后应检查：

• Server URL 是否适用于当前环境。
• 路径变量和查询参数是否完整。
• 认证头是否应改用敏感环境变量。
• 请求体示例是否包含真实个人信息或凭据。

使用环境变量

为开发、测试和生产联调环境分别定义变量。密码、Token 和密钥应标记为敏感变量，由系统加密保存并在界面中脱敏。

变量未解析、JSON 无效、Header 重复等问题会产生轻量提示；提示用于提前发现问题，不替代目标服务的契约校验。

批量运行集合

1. 选择项目并打开 Run。
2. 确认运行环境和目标地址。
3. 执行集合并查看逐请求通过/失败结果。
4. 对失败项恢复到请求工作区继续调试。
5. 保存稳定响应为示例，作为后续比较依据。

项目 Export 包含文件夹、请求、环境、说明和响应示例，适合在隔离环境之间迁移。导入前仍应检查包中是否包含不应传播的目标地址或敏感业务数据。