8.8 KiB
1. 资产钱包概况 (需要新增我的钱包页面, 放到我的钱包里面)
接口说明
获取某个资产（卡 / 设备）的钱包余额信息。
⚠️ 企业账号不可调用。
- 请求方式：GET
- 接口地址：
/api/admin/assets/{asset_type}/{id}/wallet - 认证方式：Bearer Token
请求参数
Path 参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| asset_type | string | 是 | 资产类型：card / device |
| id | integer | 是 | 资产ID |
返回结构
{
"code": 0,
"msg": "success",
"data": {
"wallet_id": 1,
"balance": 10000,
"available_balance": 8000,
"frozen_balance": 2000,
"currency": "CNY",
"status": 1,
"status_text": "正常",
"resource_id": 123,
"resource_type": "iot_card",
"created_at": "2026-03-31T12:00:00Z",
"updated_at": "2026-03-31T12:00:00Z"
},
"timestamp": "2026-03-31T12:00:00Z"
}
字段说明 字段 类型 说明 wallet_id integer 钱包ID balance integer 总余额（分） available_balance integer 可用余额（分）= 总余额 - 冻结余额 frozen_balance integer 冻结金额（分） currency string 币种（固定 CNY） status integer 钱包状态 status_text string 状态说明 resource_id integer 资产ID resource_type string 资产类型（iot_card / device） created_at string 创建时间 updated_at string 更新时间
2. 我的佣金概览 (放到首页)
接口说明
获取当前账号的佣金整体情况（可提现、冻结、累计等）。
- 请求方式：GET
- 接口地址：
/api/admin/my/commission-summary - 认证方式：Bearer Token
请求参数
无
返回结构
{
"code": 0,
"msg": "success",
"data": {
"shop_id": 1,
"shop_name": "测试店铺",
"total_commission": 100000,
"available_commission": 50000,
"frozen_commission": 10000,
"unwithdraw_commission": 30000,
"withdrawing_commission": 10000,
"withdrawn_commission": 40000
},
"timestamp": "2026-03-31T12:00:00Z"
}
字段说明 字段 类型 说明 shop_id integer 店铺ID shop_name string 店铺名称 total_commission integer 累计佣金（分） available_commission integer 可提现佣金（分） frozen_commission integer 冻结佣金（分） unwithdraw_commission integer 未提现佣金（分） withdrawing_commission integer 提现中金额（分） withdrawn_commission integer 已提现佣金（分）
3. 我的佣金明细 (放到佣金中心里面)
接口说明
获取当前账号的佣金流水记录（每一笔赚的钱）。
- 请求方式：GET
- 接口地址：
/api/admin/my/commission-records - 认证方式：Bearer Token
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | 否 | 页码（默认1） |
| page_size | integer | 否 | 每页数量（最大100） |
| commission_source | string | 否 | 佣金来源 |
| iccid | string | 否 | ICCID（模糊查询） |
| virtual_no | string | 否 | 设备虚拟号（模糊查询） |
| order_no | string | 否 | 订单号（模糊查询） |
返回结构
{
"code": 0,
"msg": "success",
"data": {
"items": [],
"page": 1,
"size": 10,
"total": 100
},
"timestamp": "2026-03-31T12:00:00Z"
}
items 字段说明（佣金记录） 字段 类型 说明 id integer 记录ID amount integer 佣金金额（分） commission_source string 佣金来源 status integer 状态 status_name string 状态名称 order_id integer 订单ID shop_id integer 店铺ID created_at string 创建时间 佣金来源说明 值 含义 cost_diff 成本价差（赚差价） one_time 一次性佣金 tier_bonus 梯度奖励（已废弃） 状态说明 状态 含义 1 已入账（有效收入） 2 已失效（不算钱）
4. 我的佣金统计(放到佣金中心里面)
接口说明
按时间范围统计佣金收入情况（总收入 + 分类占比）。
- 请求方式：GET
- 接口地址：
/api/admin/my/commission-stats - 认证方式：Bearer Token
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shop_id | integer | 否 | 店铺ID |
| start_time | string | 否 | 开始时间 |
| end_time | string | 否 | 结束时间 |
返回结构
{
"code": 0,
"msg": "success",
"data": {
"total_amount": 100000,
"total_count": 50,
"cost_diff_amount": 60000,
"cost_diff_count": 30,
"cost_diff_percent": 600,
"one_time_amount": 40000,
"one_time_count": 20,
"one_time_percent": 400
},
"timestamp": "2026-03-31T12:00:00Z"
}
字段说明 字段 类型 说明 total_amount integer 总佣金（分） total_count integer 总笔数 cost_diff_amount integer 成本价差收入（分） cost_diff_count integer 成本价差笔数 cost_diff_percent integer 成本价差占比（千分比） one_time_amount integer 一次性佣金（分） one_time_count integer 一次性佣金笔数 one_time_percent integer 一次性佣金占比（千分比） 特别说明 占比是千分比 600 = 60% 400 = 40%
5. 我的每日佣金统计 (放到首页)
接口说明
按天查看佣金收入趋势（每天赚了多少）。
- 请求方式：GET
- 接口地址：
/api/admin/my/commission-daily-stats - 认证方式：Bearer Token
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| shop_id | integer | 否 | 店铺ID |
| start_date | string | 否 | 开始日期（YYYY-MM-DD） |
| end_date | string | 否 | 结束日期（YYYY-MM-DD） |
| days | integer | 否 | 查询天数（默认30，最大365） |
返回结构
{
"code": 0,
"msg": "success",
"data": [
{
"date": "2026-03-01",
"total_amount": 1000,
"total_count": 5
},
{
"date": "2026-03-02",
"total_amount": 2000,
"total_count": 8
}
],
"timestamp": "2026-03-31T12:00:00Z"
}
字段说明 字段 类型 说明 date string 日期 total_amount integer 当日佣金（分） total_count integer 当日笔数 使用场景 做折线图（收入趋势） 看哪天赚钱最多 分析增长情况
6. 发起提现申请 (放到提现管理里面)
接口说明
提交佣金提现申请（目前只支持支付宝）。
- 请求方式：POST
- 接口地址：
/api/admin/my/withdrawal-requests - 认证方式：Bearer Token
请求参数（Body）
{
"account_name": "张三",
"account_number": "1234567890",
"amount": 10000,
"withdrawal_method": "alipay"
}
参数说明
参数名 类型 必填 说明
account_name string 是 收款人姓名
account_number string 是 收款账号（支付宝）
amount integer 是 提现金额（分）
withdrawal_method string 是 提现方式（固定：alipay）
返回结构
{
"code": 0,
"msg": "success",
"data": {
"id": 1,
"withdrawal_no": "WD202603310001",
"amount": 10000,
"actual_amount": 9800,
"fee": 200,
"fee_rate": 200,
"status": 1,
"status_name": "审核中",
"created_at": "2026-03-31T12:00:00Z"
},
"timestamp": "2026-03-31T12:00:00Z"
}
字段说明 字段 类型 说明 id integer 提现申请ID withdrawal_no string 提现单号 amount integer 申请金额（分） actual_amount integer 实际到账金额（分） fee integer 手续费（分） fee_rate integer 手续费率（基点） status integer 状态 status_name string 状态名称 created_at string 申请时间 状态说明（常见） 状态 含义 1 审核中 2 已打款 3 已拒绝 计算说明 实际到账 = 提现金额 - 手续费 手续费 = amount × fee_rate
7. 我的提现记录(放到提现管理里面)
接口信息 接口地址：GET /api/admin/my/withdrawal-requests 接口说明：获取当前用户的提现记录列表 认证方式：Bearer Token 请求参数 参数名 类型 必填 说明 page integer 否 页码（>=1） page_size integer 否 每页数量（1-100） status integer 否 状态（1=待审批，2=已通过，3=已拒绝） start_time string 否 开始时间 end_time string 否 结束时间 响应结构 { "code": 0, "msg": "success", "timestamp": "2024-01-01T00:00:00Z", "data": { "items": [], "page": 1, "size": 10, "total": 100 } } data 字段说明 字段 类型 说明 items array 提现列表 page integer 当前页 size integer 每页数量 total integer 总数 items 字段说明 字段 说明 id 提现ID withdrawal_no 提现单号 applicant_name 申请人 amount 提现金额（分） actual_amount 实际到账（分） fee 手续费 fee_rate 手续费率 status 状态（1待审 2通过 3拒绝 4到账） status_name 状态名称 withdrawal_method 提现方式（支付宝/微信/银行卡） account_name 收款人 account_number 收款账号 bank_name 银行 created_at 申请时间 processed_at 处理时间 reject_reason 拒绝原因 remark 备注