概述
好停提供完整的Postman Collection，基于OpenAPI 3.0规范生成，包含所有API接口的预配置请求。通过导入Collection和环境变量模板，您可以在几分钟内开始测试所有接口，无需手动编写任何请求。Collection内置了自动化脚本，支持Token自动管理和环境切换。
下载链接
Postman Collection文件下载地址：https://api.parkinglink.cn/docs/postman-collection.json。环境变量模板下载地址：https://api.parkinglink.cn/docs/postman-environment.json。两个文件也可以在好停开发者门户的下载页面获取最新版本。建议定期检查更新，以确保Collection中的接口与最新API版本保持一致。每个版本的Collection都标注了对应的API版本号，请使用与您对接版本匹配的Collection文件。
环境变量配置
导入环境变量模板后，需要配置以下关键变量：base_url设置为https://api.parkinglink.cn，api_key设置为您的client_id，api_secret设置为您的client_secret，access_token通过调用认证接口自动填充（Postman的Pre-request Script会自动处理Token获取和刷新），parking_lot_id设置为您测试用的停车场ID，test_plate设置为测试车牌号。
Token自动管理：Collection内置了Pre-request Script脚本，在每次请求前自动检查access_token是否过期。如果过期，脚本会自动调用认证接口获取新Token并更新环境变量，确保测试流程不中断。您无需手动管理Token生命周期。
环境切换：您可以创建多个Environment（如Development、Staging、Production），在右上角环境选择器中快速切换，无需修改请求配置。
导入方法
打开Postman应用（桌面版或Web版均可），点击左上角的Import按钮，选择File标签页，将下载的postman-collection.json文件拖入或点击Upload Files选择文件。导入成功后，左侧Collections面板会出现好停ParkingLink API文件夹，按模块（认证、停车场、订单、支付、统计、Webhook）组织。
同样方式导入postman-environment.json环境变量文件，导入后在右上角环境选择器中切换到ParkingLink Environment。如果使用Postman Web版，步骤类似，但需要先在Postman Web界面登录账号，然后通过Import功能导入文件。Web版支持团队共享Collection，方便多人协作测试。
接口测试流程
推荐的测试流程：第一步，展开Collection中的认证文件夹，发送获取Access Token请求（POST /api/v1/auth/token），确认返回200状态码和access_token；第二步，发送获取停车场列表请求，确认返回停车场数据；第三步，使用返回的parking_lot_id发送获取停车场详情请求；第四步，发送创建停车订单请求，记录返回的order_id；第五步，使用order_id发送发起支付请求；第六步，发送查询订单详情请求确认支付结果。每个步骤的响应都会自动保存到环境变量中，供后续请求使用。
常用测试场景
场景一：完整停车流程测试。依次调用创建订单、查询订单、发起支付、查询支付结果四个接口，模拟车辆从入场到支付离场的完整流程。场景二：异常场景测试。传入无效的parking_lot_id测试错误处理，使用过期的access_token测试认证错误，传入不完整的参数测试参数校验。场景三：分页测试。调用列表接口，传入不同的page和size参数，验证分页数据的正确性和边界条件。场景四：并发测试。使用Postman的Collection Runner功能，设置迭代次数和并发数，测试接口在并发场景下的稳定性和性能表现。场景五：环境切换测试。创建Development、Staging、Production三个环境变量文件，分别配置不同的base_url和密钥，逐个切换环境进行测试，确保各环境配置正确且接口可用性一致。Postman也支持通过Newman命令行工具在CI/CD流水线中自动运行Collection测试，实现接口自动化回归测试。