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