Appearance
points API(积分)
路由:
POST /api/v1/points(action 协议:{"action": "...", "payload": {...}}) 错误码段:40409xxx(全表见错误码权威注册表) 鉴权:全部需登录 字段真相:src/app/points/application/usecase/(Request dataclass)+tests/integration/test_points_actions.py(可执行契约)
Action 一览(4)
| action | 鉴权 | 说明 |
|---|---|---|
myBalance | 登录 | 积分余额 + 记录(今日签短路) |
signin | 登录 | 签到(防重 / 连续 7 天 +50) |
myTasks | 登录 | 任务列表(本月订单 done) |
awardShare | 登录 | 分享得积分(日限 3,第 4 次 awarded=false) |
通用约定
- 信封:HTTP 200 +
{"code","msg","data"};code="0"成功;404409002未登录(HTTP 401);404409001参数错(HTTP 400) - 写操作均落 audit/测试可断言(集成测试 = 可执行契约)
变更记录
| 日期 | 内容 |
|---|---|
| 2026-09-16 | 首版(四域审查棒 3 — action 清单代码直出) |