蓝桥智能体赛道 · 接口测试实践用被测服务 | 版本 v1 | 构建 2026-11-16 | 全部接口无状态、纯函数
除文档页与健康检查外,所有接口都要求在请求头带上令牌:
X-Api-Token: lanqiao-stu-2026
缺失或值不正确一律返回 401,响应体 {"code":40100}。
这个服务刻意把两者分开,请务必分清:
| 层次 | 含义 | HTTP 状态 | 响应体 code |
|---|---|---|---|
| 传输 / 协议层 | 接口不存在、方法不对、没令牌、JSON 语法错 | 404/405/401/400 | 非 0 |
| 参数层 | JSON 合法,但字段缺失、类型错、超范围 | 400 | 非 0,且带 errors 数组 |
| 业务层 | 参数合法,但这次调用在业务上不成立 | 200 | 非 0,如 40002 |
| 业务成功 | 正常算出结果 | 200 | 0 |
200、code: 0,只是 couponApplied: false。
只看 code 等于 0 就判通过,会漏掉这一类用例。
{
"code": 0,
"message": "ok",
"data": { ... }
}
POST/api/v1/calc
基础层接口。它不负责考你业务,只负责帮你把「上传文件 → 解析 → 循环 → 调用 → 比对 → 汇总」这条管线先跑通。
| 字段 | 类型 | 必填 | 规则 |
|---|---|---|---|
a | number | 是 | 有限数字,绝对值不超过 1000000 |
b | number | 是 | 同上 |
op | string | 是 | 只能是 + - * / |
| code | HTTP | 含义 |
|---|---|---|
40001 | 400 | 参数校验失败,errors 里逐条列出所有问题 |
40002 | 200 | 除数为 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
主战场。订单金额、会员等级、优惠券三者组合,算出一笔订单最终该付多少钱。
| 字段 | 类型 | 必填 | 规则 |
|---|---|---|---|
orderAmount | number | 是 | 范围 [0.01, 100000],最多两位小数 |
memberLevel | string | 否 | none(默认)/ silver / gold |
coupon | object | 否 | 不传等同 {"type":"none"} |
coupon.type | string | — | none / full_reduction(满减)/ discount(折扣) |
coupon.threshold | number | — | 门槛金额,>= 0,最多两位小数。为 0 表示无门槛 |
coupon.value | number | — | 满减券:减多少钱,> 0 且 <= threshold折扣券:折扣率,必须在 (0, 1) 开区间,0.85 表示 85 折 |
none = 1,silver = 0.98,gold = 0.95。round2(orderAmount × 折扣率);会员优惠 = orderAmount − 会员折后金额。>= threshold 才能用券。value;折扣券:优惠 = 会员折后金额 − round2(会员折后金额 × value)。round2(会员折后金额 − 券优惠),最小 0。gold 会员折后是 190,如果券门槛是 200 就用不了。
判断「能不能用」看的是 190 而不是 200 —— 差 0.01 都不行。
| 字段 | 类型 | 说明 |
|---|---|---|
data.originAmount | number | 原价 |
data.memberDiscount | number | 会员优惠金额 |
data.couponDiscount | number | 券优惠金额(没用上则为 0) |
data.payableAmount | number | 最终应付 |
data.couponApplied | boolean | 券到底有没有用上 |
data.reason | string | ok / no_coupon(没传券)/ threshold_not_met(未达门槛) |
| code | HTTP | 含义 |
|---|---|---|
40001 | 400 | orderAmount 缺失 / 类型错 / 超范围 / 超过两位小数 |
40002 | 400 | memberLevel 取值非法 |
40003 | 400 | coupon 结构或取值非法 |
# 请求: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"
}
}
| code | HTTP | 含义 |
|---|---|---|
0 | 200 | 成功(含业务上不成立但流程正常的情况) |
40000 | 400 | 请求体不是合法 JSON 对象 |
40001 | 400 | 参数校验失败 |
40002 | 200 或 400 | /calc:除数为 0(200);/coupon/quote:会员等级非法(400) |
40003 | 400 | 优惠券结构或取值非法 |
40100 | 401 | 鉴权失败 |
40400 | 404 | 路由不存在 |
40500 | 405 | 方法不允许 |
GET/api/v1/health
不需要令牌。用来确认网络通不通、域名对不对。返回 {"code":0,"data":{"status":"up"}} 即可视为连通。