1. 引言
在日常开发中，电商系统的接口调试往往需要反复填写请求头、拼接参数、处理签名，效率低下且容易出错。Postman 作为最流行的 API 调试工具，支持环境变量、集合管理、脚本断言等能力，可以大幅提升接口联调效率。本文将整理一套常见的电商 API Postman 合集，覆盖商品、订单、用户、支付等核心模块，帮助开发者开箱即用、一键调用。
2. 准备工作
在开始使用合集之前，需要先完成以下准备工作：
- 安装 Postman 桌面版或使用 Web 版。
- 准备一套可访问的电商后端服务地址，例如
https://api.example.com。 - 获取接口访问所需的 Token 或 AppKey，用于鉴权。
建议在 Postman 中提前配置好环境变量，将域名、Token 等公共信息统一管理，方便后续切换测试环境和生产环境。
3. 环境变量配置
为了让合集在不同环境之间灵活切换，推荐在 Postman 中创建环境变量。以下是常用的变量定义：
| 变量名 | 示例值 | 说明 |
|---|---|---|
base_url | https://api.example.com | 接口服务地址 |
token | eyJhbGciOi... | 访问令牌 |
app_key | your_app_key | 应用标识 |
order_id | 20261009001 | 示例订单号 |
在请求中使用 {{base_url}}、{{token}} 等占位符，即可自动替换为当前环境对应的值。
4. 商品模块 API
商品模块是电商系统的核心，以下接口覆盖商品查询、详情、上下架等常见操作。
4.1 商品列表查询
GET {{base_url}}/api/v1/products?page=1&size=20
Authorization: Bearer {{token}}该接口支持分页查询，返回商品名称、价格、库存、状态等字段。可在 Tests 脚本中校验返回码是否为 200：
pm.test("状态码为 200", function () {
pm.response.to.have.status(200);
});4.2 商品详情
GET {{base_url}}/api/v1/products/{{product_id}}
Authorization: Bearer {{token}}通过商品 ID 获取单个商品的完整信息，包括图文详情、规格参数、SKU 列表等。
4.3 商品上下架
PUT {{base_url}}/api/v1/products/{{product_id}}/status
Content-Type: application/json
Authorization: Bearer {{token}}
{
"status": "on_sale"
}该接口用于修改商品上下架状态，on_sale 表示上架，off_sale 表示下架。
5. 订单模块 API
订单模块涉及创建、查询、取消、发货等核心流程，是电商联调中频率最高的接口集合。
5.1 创建订单
POST {{base_url}}/api/v1/orders
Content-Type: application/json
Authorization: Bearer {{token}}
{
"user_id": "10001",
"items": [
{
"product_id": "P001",
"quantity": 2
}
],
"address_id": "A001"
}创建成功后返回订单号，可在 Tests 脚本中提取并保存到环境变量，供后续接口使用：
const res = pm.response.json();
pm.environment.set("order_id", res.data.order_id);5.2 订单详情查询
GET {{base_url}}/api/v1/orders/{{order_id}}
Authorization: Bearer {{token}}5.3 取消订单
POST {{base_url}}/api/v1/orders/{{order_id}}/cancel
Content-Type: application/json
Authorization: Bearer {{token}}
{
"reason": "用户主动取消"
}6. 用户模块 API
用户模块主要包含注册、登录、个人信息查询与地址管理，是电商业务的基础支撑。
6.1 用户注册
POST {{base_url}}/api/v1/users/register
Content-Type: application/json
{
"mobile": "13800138000",
"password": "123456",
"nickname": "测试用户"
}6.2 用户登录
POST {{base_url}}/api/v1/users/login
Content-Type: application/json
{
"mobile": "13800138000",
"password": "123456"
}登录成功后返回 Token，建议在 Tests 脚本中自动保存：
const res = pm.response.json();
pm.environment.set("token", res.data.token);6.3 收货地址列表
GET {{base_url}}/api/v1/users/addresses
Authorization: Bearer {{token}}7. 支付模块 API
支付模块负责下单后的支付流程，包括发起支付、查询支付结果和退款操作。
7.1 发起支付
POST {{base_url}}/api/v1/payments
Content-Type: application/json
Authorization: Bearer {{token}}
{
"order_id": "{{order_id}}",
"pay_method": "wechat",
"amount": 199.00
}7.2 查询支付结果
GET {{base_url}}/api/v1/payments/{{order_id}}
Authorization: Bearer {{token}}7.3 申请退款
POST {{base_url}}/api/v1/payments/{{order_id}}/refund
Content-Type: application/json
Authorization: Bearer {{token}}
{
"reason": "商品质量问题",
"amount": 199.00
}8. 合集使用技巧
为了让这套 Postman 合集发挥最大价值，这里补充几个实用技巧：
- 使用集合变量：将公共参数如
app_key、version放在集合级别，避免重复配置。 - 编写自动化测试：在每个请求的 Tests 脚本中校验状态码、关键字段，便于回归联调。
- 使用 Runner 批量执行：将核心流程串联成文件夹，通过 Collection Runner 一键批量执行，快速验证接口稳定性。
- 导出与分享：将合集导出为 JSON 文件，或通过 Postman 的分享链接同步给团队其他成员。
9. 总结
本文整理了一套覆盖商品、订单、用户、支付四大核心模块的电商 API Postman 合集，并提供了环境变量配置、请求示例和自动化测试脚本。开发者可以直接导入使用，也可以根据自身业务扩展新的接口。合理利用 Postman 的集合、环境变量和脚本能力，能够显著提升电商接口的联调效率，减少重复劳动。如有任何疑问，欢迎留言探讨！
