wx_service/docs/expiry/reports/api_integration_2026-03-04.md

保质期接口集成测试报告（2026-03-04）

范围

• 登录获取 Token（/api/v1/auth/login）
• 物品接口：创建、列表、汇总、更新、状态标记、删除
• 设置接口：获取与更新

测试资产

• Postman Collection: docs/expiry/tests/postman/expiry.postman_collection.json
• Postman Environment: docs/expiry/tests/postman/expiry.postman_environment.json
• 一键脚本: scripts/expiry/run_integration_tests.sh

执行方式

# 方式一：已有 token
BASE_URL=http://127.0.0.1:8080 TOKEN=<session_key> scripts/expiry/run_integration_tests.sh

# 方式二：通过 wx.login 的 code 登录
BASE_URL=http://127.0.0.1:8080 MINI_PROGRAM_ID=1 WX_CODE=<wx_code> scripts/expiry/run_integration_tests.sh

断言规则

• 登录接口：HTTP 200 && code == 200
• 业务接口：HTTP 200 && code == 0
• 错误接口：预期返回 4xx/5xx 与对应 message

性能测试建议

脚本内置 hey 调用（若系统已安装）：

hey -n 100 -c 20 -H "Authorization: Bearer <token>" http://127.0.0.1:8080/api/expiry/summary

目标：平均响应时间 < 200ms（开发环境仅作参考，生产环境需复测）。