电商测试实战接口文档

接口基础地址：

http://43.133.227.52/api

通用响应格式

{
  "code": 0,
  "message": "success"
}

异常响应示例：

{
  "code": 401,
  "message": "请先登录，或检查 token 是否正确"
}

鉴权方式

登录成功后接口返回 token，后续请求在 Header 中传：

Authorization: Bearer <token>

1. 健康检查

GET http://43.133.227.52/api/health

用途：检查后端服务是否正常运行。

2. 登录

POST http://43.133.227.52/api/login

请求体：

{
  "username": "tester",
  "password": "123456"
}

响应示例：

{
  "code": 0,
  "message": "success",
  "token": "practice-1-xxx",
  "user": {
    "id": 1,
    "username": "tester",
    "name": "测试同学",
    "role": "qa"
  }
}

测试点：

正确账号密码。
错误密码。
空账号 / 空密码。
响应中是否返回 token。
token 格式和后续接口可用性。

3. 商品列表

GET http://43.133.227.52/api/products

需要登录。

测试点：

未登录访问返回 401。
商品字段完整：id、name、price、stock。
库存为 0 的商品前端是否禁用加入购物车。

4. 查询购物车

GET http://43.133.227.52/api/cart

需要登录。

响应字段：

items：购物车商品列表。
totalAmount：购物车总金额。

5. 加入购物车

POST http://43.133.227.52/api/cart

需要登录。

请求体：

{
  "productId": 101,
  "quantity": 1
}

测试点：

正常加入购物车。
重复加入同一商品。
quantity 为 0 或负数。
不存在的 productId。
库存为 0 的商品。

6. 删除购物车商品

DELETE http://43.133.227.52/api/cart/:productId

示例：

DELETE http://43.133.227.52/api/cart/101

测试点：

删除存在商品。
删除不存在商品。
删除后购物车金额和数量是否更新。

7. 创建订单

POST http://43.133.227.52/api/orders

需要登录。请求体可以为空。

测试点：

购物车为空时创建订单。
购物车有商品时创建订单。
创建订单后购物车是否清空。
商品库存是否扣减。
订单金额是否等于商品小计之和。

8. 查询订单列表

GET http://43.133.227.52/api/orders

需要登录。

测试点：

只返回当前用户订单。
新订单是否排在前面。
订单状态文案是否正确。

9. 查询订单详情

GET http://43.133.227.52/api/orders/:id

示例：

GET http://43.133.227.52/api/orders/NO10001

测试点：

查询存在订单。
查询不存在订单。
查询其他用户订单。

10. 支付订单

POST http://43.133.227.52/api/orders/:id/pay

测试点：

待支付订单可以支付。
已取消订单不能支付。
不存在订单不能支付。
重复支付是否被合理处理。

11. 取消订单

POST http://43.133.227.52/api/orders/:id/cancel

测试点：

待支付订单可以取消。
已支付订单不能取消。
不存在订单不能取消。

12. 重置练习数据

POST http://43.133.227.52/api/reset

需要管理员账号：

admin / admin123

测试点：

普通用户调用返回 403。
管理员调用成功。
重置后订单、购物车、库存是否恢复初始状态。

Postman 测试建议

创建环境变量：baseUrl = http://43.133.227.52/api。
登录接口把返回的 token 写入环境变量。
后续接口统一使用 Authorization: Bearer {{token}}。
优先覆盖登录、购物车、下单、支付、取消 5 条主链路。
再补异常场景和边界场景。