接口测试靶场

蓝桥智能体赛道 · 接口测试实践用被测服务  |  版本 v1  |  构建 2026-11-16  |  全部接口无状态、纯函数

通用约定

1. 鉴权

除文档页与健康检查外,所有接口都要求在请求头带上令牌:

X-Api-Token: lanqiao-stu-2026

缺失或值不正确一律返回 401,响应体 {"code":40100}。

2. HTTP 状态码和业务码是两回事

这个服务刻意把两者分开,请务必分清:

层次含义HTTP 状态响应体 code
传输 / 协议层接口不存在、方法不对、没令牌、JSON 语法错404/405/401/400非 0
参数层JSON 合法,但字段缺失、类型错、超范围400非 0,且带 errors 数组
业务层参数合法,但这次调用在业务上不成立200非 0,如 40002
业务成功正常算出结果2000
最容易踩的坑:优惠券没用上(门槛没达到)不是错误。它返回 200、code: 0,只是 couponApplied: false。 只看 code 等于 0 就判通过,会漏掉这一类用例。

3. 所有响应都是 JSON

{
  "code": 0,
  "message": "ok",
  "data": { ... }
}

接口一 · 四则运算

POST/api/v1/calc

基础层接口。它不负责考你业务,只负责帮你把「上传文件 → 解析 → 循环 → 调用 → 比对 → 汇总」这条管线先跑通。

请求参数

字段类型必填规则
anumber是有限数字,绝对值不超过 1000000
bnumber是同上
opstring是只能是 + - * /

错误码

codeHTTP含义
40001400参数校验失败,errors 里逐条列出所有问题
40002200除数为 0(参数合法,业务不成立)

示例

# 请求
curl -s -X POST https://<你的域名>/api/v1/calc \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: lanqiao-stu-2026" \
  -d '{"a": 10, "b": 4, "op": "/"}'

# 响应
{"code": 0, "message": "ok", "data": {"result": 2.5}}

注意:结果保留 6 位小数。所以 0.1 * 0.2 返回 0.02,不是 0.020000000000000004。

接口二 · 优惠券结算(后续任务用,本次不需要,点开才看)

接口二 · 优惠券结算

POST/api/v1/coupon/quote

主战场。订单金额、会员等级、优惠券三者组合,算出一笔订单最终该付多少钱。

请求参数

字段类型必填规则
orderAmountnumber是范围 [0.01, 100000],最多两位小数
memberLevelstring否none(默认)/ silver / gold
couponobject否不传等同 {"type":"none"}
coupon.typestring—none / full_reduction(满减)/ discount(折扣)
coupon.thresholdnumber—门槛金额,>= 0,最多两位小数。为 0 表示无门槛
coupon.valuenumber—满减券:减多少钱,> 0 且 <= threshold
折扣券:折扣率,必须在 (0, 1) 开区间,0.85 表示 85 折

计算规则(必须按顺序)

  1. 会员折扣率:none = 1,silver = 0.98,gold = 0.95。
  2. 会员折后金额 = round2(orderAmount × 折扣率);会员优惠 = orderAmount − 会员折后金额。
  3. 判断券门槛时,看的是会员折后金额,不是原价。折后金额 >= threshold 才能用券。
  4. 满减券:优惠 = value;折扣券:优惠 = 会员折后金额 − round2(会员折后金额 × value)。
  5. 应付金额 = round2(会员折后金额 − 券优惠),最小 0。
  6. 所有金额一律四舍五入保留 2 位。
这条规则藏着好几个边界:原价 200 的订单,gold 会员折后是 190,如果券门槛是 200 就用不了。 判断「能不能用」看的是 190 而不是 200 —— 差 0.01 都不行。

响应字段

字段类型说明
data.originAmountnumber原价
data.memberDiscountnumber会员优惠金额
data.couponDiscountnumber券优惠金额(没用上则为 0)
data.payableAmountnumber最终应付
data.couponAppliedboolean券到底有没有用上
data.reasonstringok / no_coupon(没传券)/ threshold_not_met(未达门槛)

错误码

codeHTTP含义
40001400orderAmount 缺失 / 类型错 / 超范围 / 超过两位小数
40002400memberLevel 取值非法
40003400coupon 结构或取值非法

示例

# 请求:200 元订单,gold 会员,满 200 减 30
curl -s -X POST https://<你的域名>/api/v1/coupon/quote \
  -H "Content-Type: application/json" \
  -H "X-Api-Token: lanqiao-stu-2026" \
  -d '{"orderAmount":200,"memberLevel":"gold","coupon":{"type":"full_reduction","threshold":200,"value":30}}'

# 响应:折后 190 没到 200 门槛,券没用上
{
  "code": 0,
  "message": "ok",
  "data": {
    "originAmount": 200,
    "memberDiscount": 10,
    "couponDiscount": 0,
    "payableAmount": 190,
    "couponApplied": false,
    "reason": "threshold_not_met"
  }
}

错误码总表

codeHTTP含义
0200成功(含业务上不成立但流程正常的情况)
40000400请求体不是合法 JSON 对象
40001400参数校验失败
40002200 或 400/calc:除数为 0(200);/coupon/quote:会员等级非法(400)
40003400优惠券结构或取值非法
40100401鉴权失败
40400404路由不存在
40500405方法不允许

健康检查

GET/api/v1/health

不需要令牌。用来确认网络通不通、域名对不对。返回 {"code":0,"data":{"status":"up"}} 即可视为连通。