| code required | string 兑换码 |
| email required | string 收券会员邮箱（用于定位我方会员） |
| requestId | string 外部请求流水号，用于幂等防重（可选） |
{- "code": "E602F4DC626E4948",
- "email": "user@example.com",
- "requestId": "REQ-20260604-0001"
}string 用户邮箱 | |
| unionId | string 会员编号（unionId） |
| userId | integer <int64> 用户ID |
| couponIds required | Array of integers <int64> [ items <int64 > ] 优惠券ID列表 |
{- "email": "user@example.com",
- "unionId": "M123456",
- "userId": 1024,
- "couponIds": [
- 0
]
}| pageNo | integer <int32> 页码，从 1 开始 |
| pageSize | integer <int32> 每页条数 |
string 用户邮箱 | |
| unionId | string 会员编号（unionId） |
| userId | integer <int64> 用户ID |
| status | string 优惠券状态编码：UNUSED/USED/FINISH/EXPIRE/INVALID；不传则返回全部 |
| code | string 优惠券券码（模糊匹配） |
| templateId | integer <int64> 优惠券模板ID |
{- "pageNo": 1,
- "pageSize": 10,
- "email": "user@example.com",
- "unionId": "M123456",
- "userId": 1024,
- "status": "UNUSED",
- "code": "21224752056818",
- "templateId": 7488
}string 用户邮箱 | |
| unionId | string 会员编号（unionId） |
| userId | integer <int64> 用户ID |
| couponIds required | Array of integers <int64> [ items <int64 > ] 优惠券ID列表 |
| extendDays required | integer <int32> [ 1 .. 365 ] 延期天数 |
{- "email": "user@example.com",
- "unionId": "M123456",
- "userId": 1024,
- "couponIds": [
- 0
], - "extendDays": 30
}| pageNo | integer <int32> Page number, starting from 1 |
| pageSize | integer <int32> Page size |
| rno required | string Promoter referral code (rno) |
| categoryCode | string Promoter custom category code; omit to list all categories |
| keyword | string Search keyword matched against product title |
| source | integer <int32> Product source: 1=Taobao, 2=1688, 3=Weidian |
| sort | integer <int32> Sort order: omit=created time desc; 1=sales desc; 2=price asc; 3=price desc |
| minGoodsPrice | integer <int64> Minimum price in CNY cents |
| maxGoodsPrice | integer <int64> Maximum price in CNY cents |
{- "pageNo": 1,
- "pageSize": 10,
- "rno": "ABC123",
- "categoryCode": "cat_001",
- "keyword": "sneakers",
- "source": 1,
- "sort": 1,
- "minGoodsPrice": 1000,
- "maxGoodsPrice": 50000
}