Skip to content

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 清单代码直出)