开发者必备:Postman合集,一键调用常见电商API

简介: 本文整理了一套开箱即用的电商API Postman合集,覆盖商品、订单、用户、支付四大核心模块,支持环境变量切换、自动化测试与批量执行,助开发者高效完成接口联调,大幅提升调试效率与准确性。(239字)

​

  1. 引言
    在日常开发中,电商系统的接口调试往往需要反复填写请求头、拼接参数、处理签名,效率低下且容易出错。Postman 作为最流行的 API 调试工具,支持环境变量、集合管理、脚本断言等能力,可以大幅提升接口联调效率。本文将整理一套常见的电商 API Postman 合集,覆盖商品、订单、用户、支付等核心模块,帮助开发者开箱即用、一键调用。

  2. 准备工作
    在开始使用合集之前,需要先完成以下准备工作:

安装 Postman 桌面版或使用 Web 版。
准备一套可访问的电商后端服务地址,例如 https://api.example.com。
获取接口访问所需的 Token 或 AppKey,用于鉴权。
建议在 Postman 中提前配置好环境变量,将域名、Token 等公共信息统一管理,方便后续切换测试环境和生产环境。

  1. 环境变量配置
    为了让合集在不同环境之间灵活切换,推荐在 Postman 中创建环境变量。以下是常用的变量定义:

变量名 示例值 说明
base_url https://api.example.com 接口服务地址
token eyJhbGciOi... 访问令牌
app_key your_app_key 应用标识
order_id 20261009001 示例订单号
在请求中使用 { {base_url}}、{ {token}} 等占位符,即可自动替换为当前环境对应的值。

  1. 商品模块 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 表示下架。

  1. 订单模块 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": "用户主动取消"
}

  1. 用户模块 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}}

  1. 支付模块 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
}

  1. 合集使用技巧
    为了让这套 Postman 合集发挥最大价值,这里补充几个实用技巧:

使用集合变量:将公共参数如 app_key、version 放在集合级别,避免重复配置。
编写自动化测试:在每个请求的 Tests 脚本中校验状态码、关键字段,便于回归联调。
使用 Runner 批量执行:将核心流程串联成文件夹,通过 Collection Runner 一键批量执行,快速验证接口稳定性。
导出与分享:将合集导出为 JSON 文件,或通过 Postman 的分享链接同步给团队其他成员。

  1. 总结
    本文整理了一套覆盖商品、订单、用户、支付四大核心模块的电商 API Postman 合集,并提供了环境变量配置、请求示例和自动化测试脚本。开发者可以直接导入使用,也可以根据自身业务扩展新的接口。合理利用 Postman 的集合、环境变量和脚本能力,能够显著提升电商接口的联调效率,减少重复劳动。如有任何疑问,欢迎留言探讨!

​

相关文章
|
7月前
|
人工智能 JSON 算法
1688 图片搜索逆向工程与多模态搜索融合实践 —— 基于 CLIP 模型的特征向量落地
本文分享了合规逆向1688 APP图片搜同款功能的完整实践:通过抓包与反编译厘清请求逻辑,破解动态签名算法,并融合CLIP多模态特征与Faiss向量检索,显著提升搜款准确率(62%→91%)与效率(3秒出结果)。全程基于公开产品分析,严守法律红线。
|
1月前
|
人工智能 运维 搜索推荐
给AI Agent接入联网搜索:一个可落地的检索流水线
为AI Agent添加联网搜索,远不止调用API:需构建完整检索链路——精准判断搜索必要性、多轮查询改写、结果标准化去重、权威来源排序、正文精读与引用校验,才能确保答案既实时又可靠。(239字)
|
1月前
|
存储 缓存 人工智能
聊天消息时间为什么差8小时?UTC、时区与“昨天”的边界
本文剖析消息时间展示的三大误区:UTC时刻≠本地钟表时间、“今天/昨天”取决于当地日期而非24小时差、重复钟表时间需靠UTC偏移区分。通过教学代码演示如何基于显式时区安全格式化,强调事件时刻、显示时区、当地日期三者分工,避免时区误用。(239字)
|
1月前
|
弹性计算 运维 安全
运维安全中心(堡垒机)入门:从 SSH 直连到统一审计的实操清单
从 SSH 直连的三个硬伤讲起,拆解运维安全中心(堡垒机)到底管什么:统一入口、身份鉴别、权限审批、会话录播。含开发者版/轻量版/基础版/企业双擎版四档横向对比与价格量级、并发数与资产数的计算口径、六步接入流程、控制策略配置要点、自建跳板机对比表和 7 条避坑清单。
|
2月前
|
数据采集 供应链 搜索推荐
2026年电商选品趋势:API驱动下的智能化与个性化
本文解析2026年电商选品新范式:以API为数据底座,实现选品链路的实时化、自动化与个性化。涵盖数据采集、分析建模、决策输出、执行反馈四大节点,提供工程落地路径、代码示例及避坑指南,助力技术团队构建最小可行智能选品系统。(239字)
|
6月前
|
存储 Rust NoSQL
一条命令迁移,帮你实现 OpenClaw 与 Hermes Agent 记忆互通!
本文是基于阿里云 Tablestore 的 Agent 记忆共享实战指南:一条命令迁移 OpenClaw 记忆至 Hermes,通过统一 Tablestore 实例、应用 ID 与租户 ID,实现跨Agent(如龙虾与马)记忆自动互通、实时同步与语义检索,支持 CLI 管理与对话中直接调用,安全可靠,开箱即用。
13538 128
|
11月前
|
Kubernetes Cloud Native Nacos
MCP 网关实战:基于 Higress + Nacos 的零代码工具扩展方案
本文介绍一种基于开源 Higress 与 Nacos 的私有化 MCP 智能体网关架构,实现工具动态注册、Prompt 实时更新、多租户安全隔离,并支持在无外网、无 Helm 的生产环境中一键部署。
1406 25
MCP 网关实战:基于 Higress + Nacos 的零代码工具扩展方案
|
9月前
|
安全 Linux iOS开发
IDA Pro 9.3 正式版发布 - 强大的反汇编程序、反编译器和多功能调试器
IDA Pro 9.3 (macOS, Linux, Windows) - 强大的反汇编程序、反编译器和多功能调试器
19645 9
IDA Pro 9.3 正式版发布 - 强大的反汇编程序、反编译器和多功能调试器