拼多多接口
magnate
拼多多的 list / detail / claim / purchase 走通用活动接口（kind=magnate，详见 活动接口）。purchase 入口被复用为"每日转动"动作。
活动详情字段
通用接口 GET /promotion/magnate/detail 的 data 字段：
| 字段 | 类型 | 说明 |
|---|---|---|
| description | string | 活动说明 |
| stages | list<Stage> | 阶段配置列表 |
| current_stage | number | 当前所处阶段下标（从 0 开始） |
| progress | number | 当前阶段达成进度（0~1） |
| can_spin_today | bool | 今日是否可以转动 |
| cycle_end_at | string | 当前周期结束时间（RFC3339） |
| invitee_count | number | 当前周期已达标邀请人数 |
| invitee_recharge | number | 当前周期邀请人累计充值 |
| invitee_bet | number | 当前周期邀请人累计投注 |
| stage_spin_base | number | 当前阶段已转出的基准奖励 |
| stage_cap | number | 当前阶段上限（StageCap(stage)） |
Stage 字段（来自配置）：
| 字段 | 类型 | 说明 |
|---|---|---|
| invitee_count | number | 阶段所需邀请人数 |
| invitee_recharge_amount | number | 阶段所需邀请人累计充值 |
| invitee_bet_amount | number | 阶段所需邀请人累计投注 |
| reward_amount | number | 阶段奖励金额 |
| bet_multiple | number | 阶段奖励对应的打码倍数 |
每日转动
通用接口 POST /promotion/magnate/purchase。每日仅可转动一次。
输入: 无
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| progress | number | 转动后的阶段进度 |
| stage_spin_base | number | 转出的基准奖励 |
领取阶段奖励
通用接口 POST /promotion/magnate/claim。当 current_stage 的三项条件（人数 / 充值 / 投注）全部达成时可领。
输入: {}
输出:
| 字段 | 类型 | 说明 |
|---|---|---|
| stage_index | number | 本次领取的阶段下标 |
| reward_amount | number | 入账金额 |
| bet_multiple | number | 打码倍数 |
| next_stage | number | 推进后的阶段下标 |