Skip to content

distribution API(分销) ​

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

Action 一览(8) ​

action鉴权说明
mySummary登录分销总览
myOrders登录分销订单
myTeam登录我的团队
myCommissionLogs登录佣金流水(settle/clawback)
myLevel登录分销等级
inviteInfo登录邀请信息(ensure_invite_code)
withdrawRequest登录提现申请(最低额/余额校验)
myWithdrawals登录提现记录

通用约定 ​

  • 信封:HTTP 200 + {"code","msg","data"};code="0" 成功;404414002 未登录(HTTP 401);404414001 参数错(HTTP 400)
  • 写操作均落 audit/测试可断言(集成测试 = 可执行契约)

变更记录 ​

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