4. 环境准备：Python环境搭建，安装requests库，Postman工具介绍与基本使用
在开始调用工期索赔影响评估接口之前，必须完成本地开发环境的搭建。本节将引导你完成Python运行环境配置、核心HTTP库安装以及API调试工具Postman的安装与基础操作，确保后续实战环节能够顺畅进行。
4.1 Python环境搭建
Python是本次课程接口调用的主要编程语言。推荐使用Python 3.8及以上版本，以兼容requests库的最新特性及SSL/TLS安全协议。
| 步骤 | 操作 | 验证命令 |
|---|---|---|
| 1 | 访问 python.org 下载对应操作系统的安装包 | — |
| 2 | 安装时勾选 "Add Python to PATH" | — |
| 3 | 打开终端（CMD / Terminal） | python --version |
| 4 | 确认pip包管理器可用 | pip --version |
💡 提示： 若系统已安装多个Python版本，建议使用
python3 和 pip3 命令明确指定版本，避免环境冲突。
4.2 安装requests库
requests库是Python生态中最简洁、最流行的HTTP请求库。它封装了底层urllib3，提供直观的API用于发送GET、POST、PUT、DELETE等请求，并自动处理JSON解析、会话保持和连接池管理。
在终端中执行以下命令完成安装：
pip install requests安装完成后，通过以下Python代码验证库是否可用：
import requests
print(requests.__version__)若输出类似 2.31.0 的版本号，则说明安装成功。
📌 核心依赖： 除requests外，后续章节可能涉及
json（标准库）、datetime（标准库）和 pandas（可选，用于批量数据处理）。建议提前安装pandas：pip install pandas。
4.3 Postman工具介绍与基本使用
Postman是目前最流行的API开发和测试协作平台。它提供图形化界面，允许开发者在不编写代码的情况下构造HTTP请求、查看响应、管理环境变量和编写自动化测试脚本。在工期索赔接口调试阶段，Postman能极大提升验证效率。
4.3.1 核心功能对比
| 功能模块 | 说明 | 在工期索赔场景中的应用 |
|---|---|---|
| 请求构造器 | 选择方法、输入URL、设置Headers/Body | 构造索赔评估请求，传递变更单ID与工期数据 |
| 参数化与变量 | 使用 {{variable}} 动态替换 |
切换不同项目环境（测试/预发布/生产） |
| 集合（Collection） | 分组管理多个请求 | 将索赔评估、谈判记录、审批流程归入同一集合 |
| 测试脚本（Pre-request / Tests） | 基于JavaScript的断言与数据处理 | 自动校验响应状态码、提取、验证工期计算结果 |
| 环境与全局变量 | 隔离不同环境的配置 | 管理API Base URL、认证密钥、项目编号 |
4.3.2 基本使用流程
- 下载与安装： 访问
postman.com/downloads获取桌面版客户端，支持Windows/macOS/Linux。 - 创建工作区： 启动后创建个人工作区，避免与团队数据混淆。
- 创建第一个请求：
- 点击 "New" → "HTTP Request"。
- 设置请求方法为
POST，输入URL（例如：http://api.example.com/claim/assess）。 - 在 Headers 中添加
Content-Type: application/json。 - 在 Body 中选择
raw→JSON，粘贴请求载荷。
- 发送与查看响应： 点击 "Send"，下方区域将显示状态码、响应时间、响应体及Cookie信息。
- 保存到集合： 点击 "Save" 按钮，将请求存入指定集合，便于后续复用和分享。
⚠️ 注意： 在Postman中调试涉及敏感数据（如、认证）的接口时，切勿将真实凭证直接硬编码在请求中。应使用 环境变量 引用，并确保环境文件不被提交到版本控制系统。
4.4 环境准备总览
下图展示了本地开发环境的核心组件及其在工期索赔接口调用中的协作关系：
4.5 快速验证清单
完成上述步骤后，请逐项核对以下清单，确保环境就绪：
- ✅ Python 版本：
python --version输出 ≥ 3.8 - ✅ pip 可用：
pip --version无报错 - ✅ requests 已安装：
python -c "import requests; print(requests.__version__)"输出版本号 - ✅ Postman 已安装： 桌面客户端可正常启动并创建请求
- ✅ 基础连通性： 使用Postman发送GET请求至
https://httpbin.org/get，返回200状态码
🔧 排障建议： 若pip安装requests时出现网络超时，可尝试使用国内镜像源：
pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple。若Postman请求返回SSL证书错误，可在设置中关闭 "SSL certificate verification"（仅限本地测试环境）。