109
docs/partner-api-contract.md
普通文件
109
docs/partner-api-contract.md
普通文件
@@ -0,0 +1,109 @@
|
||||
# 合伙股东前后端接口约定(两代理必须遵守)
|
||||
|
||||
## profile `GET user.user/profile` 增补字段
|
||||
|
||||
```json
|
||||
{
|
||||
"identity_text": "品酒师",
|
||||
"identities": ["taster"],
|
||||
"is_partner": false,
|
||||
"maker_level_name": "",
|
||||
"madow": "0.00000000",
|
||||
"madow_rate": "0.00000075",
|
||||
"madow_value": "0.00",
|
||||
"voucher_available": "0.00",
|
||||
"active_30d": true
|
||||
}
|
||||
```
|
||||
|
||||
identities 取值:`taster` | `maker` | `venue` | `county`
|
||||
is_partner = 含 maker 或 venue 或 county
|
||||
identity_text 例:`品酒师` / `合伙股东 · 创客V5 · 酒道馆`
|
||||
|
||||
## agent `GET commission.agent` 在原 agent 上增补
|
||||
|
||||
```json
|
||||
{
|
||||
"is_venue": 0,
|
||||
"is_county": 0,
|
||||
"county_code": "",
|
||||
"direct_order_seq": 0,
|
||||
"madow": "0.00000000",
|
||||
"madow_rate": "0.00000075",
|
||||
"madow_value": "0.00",
|
||||
"voucher_total": "0.00",
|
||||
"voucher_released": "0.00",
|
||||
"voucher_used": "0.00",
|
||||
"voucher_available": "0.00",
|
||||
"active_30d": true,
|
||||
"last_self_order_time": 0,
|
||||
"identities": ["taster"],
|
||||
"identity_text": "品酒师",
|
||||
"is_partner": false,
|
||||
"maker_level_name": ""
|
||||
}
|
||||
```
|
||||
|
||||
team 列表里每个 user.agent 同样带 is_venue / is_county / level_info
|
||||
|
||||
## 新接口前缀 `/addons/shopro/partner.index`
|
||||
|
||||
| 方法 | 路径 | 说明 |
|
||||
|---|---|---|
|
||||
| GET | partner.index | overview |
|
||||
| GET | partner.index/rewards | 分页流水 tab=all\|push3\|maker\|venue\|county\|share |
|
||||
| GET | partner.index/madow | 马豆+汇率+日流水 |
|
||||
| GET | partner.index/voucher | 券账户+计划列表 |
|
||||
|
||||
overview:
|
||||
|
||||
```json
|
||||
{
|
||||
"month_income": "0.00",
|
||||
"skip_count": 0,
|
||||
"active_30d": true
|
||||
}
|
||||
```
|
||||
|
||||
rewards 列表项:
|
||||
|
||||
```json
|
||||
{
|
||||
"id": 1,
|
||||
"reward_type": "push3",
|
||||
"reward_type_text": "推三返一",
|
||||
"amount": "398.00",
|
||||
"madow": "0.00000000",
|
||||
"status": 1,
|
||||
"status_text": "已入账",
|
||||
"skip_reason": "",
|
||||
"skip_reason_text": "",
|
||||
"buyer_nickname": "",
|
||||
"order_id": 1,
|
||||
"createtime": "2026-09-16 10:00:00",
|
||||
"formula": ""
|
||||
}
|
||||
```
|
||||
|
||||
madow:
|
||||
|
||||
```json
|
||||
{
|
||||
"madow": "0.00000000",
|
||||
"madow_rate": "0.00000075",
|
||||
"madow_value": "0.00",
|
||||
"list": []
|
||||
}
|
||||
```
|
||||
|
||||
voucher:
|
||||
|
||||
```json
|
||||
{
|
||||
"voucher_total": "0.00",
|
||||
"voucher_released": "0.00",
|
||||
"voucher_used": "0.00",
|
||||
"voucher_available": "0.00",
|
||||
"plans": []
|
||||
}
|
||||
```
|
||||
在新工单中引用
屏蔽一个用户