coupon API（优惠券）

路由：POST /api/v1/coupon（action 协议：{"action": "...", "payload": {...}}） 错误码段：40410xxx（全表见错误码权威注册表） 鉴权：全部需登录 字段真相：src/app/coupon/application/usecase/（Request dataclass）+ tests/integration/test_coupon_actions.py（可执行契约）

Action 一览（4）

action	鉴权	说明
templates	登录	券模板（含 received 标记）
myCoupons	登录	我的券（懒标过期 + status 过滤）
availableCount	登录	可用券计数
receive	登录	领券（同 title 防重 / expireAt=now+validDays）

通用约定

• 信封：HTTP 200 + {"code","msg","data"}；code="0" 成功；404410002 未登录（HTTP 401）；404410001 参数错（HTTP 400）
• 写操作均落 audit/测试可断言（集成测试 = 可执行契约）

变更记录

日期	内容
2026-09-16	首版（四域审查棒 3 — action 清单代码直出）