# 拼多多接口

**magnate**

拼多多的 `list` / `detail` / `claim` / `purchase` 走通用活动接口（`kind=magnate`，详见 [活动接口](400_promotion.md)）。`purchase` 入口被复用为"每日转动"动作。

---

## 活动详情字段 {#detail}

通用接口 `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 | 阶段奖励对应的打码倍数

---

## 每日转动 {#purchase}

通用接口 `POST /promotion/magnate/purchase`。每日仅可转动一次。

**输入:** 无

**输出:**

字段 | 类型 | 说明
---|---|---
progress | number | 转动后的阶段进度
stage_spin_base | number | 转出的基准奖励

---

## 领取阶段奖励 {#claim}

通用接口 `POST /promotion/magnate/claim`。当 `current_stage` 的三项条件（人数 / 充值 / 投注）全部达成时可领。

**输入:** `{}`

**输出:**

字段 | 类型 | 说明
---|---|---
stage_index | number | 本次领取的阶段下标
reward_amount | number | 入账金额
bet_multiple | number | 打码倍数
next_stage | number | 推进后的阶段下标