wallet API（钱包）

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

Action 一览（3）

action	鉴权	说明
get	登录	我的钱包（自动建空钱包；balance 字符串）
transactions	登录	流水分页（createdAt desc）
recharge	登录	充值（V1.0 恒 403「payment 尚未开通」）

通用约定

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

变更记录

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