通过接口可以查询某个店铺优惠券的买家详细信息返回的信息,买家昵称, 使用渠道,使用状态,总数量
支持平台: 淘宝
通过接口可以查询某个店铺优惠券的买家详细信息返回的信息,买家昵称, 使用渠道,使用状态,总数量
支持平台: 淘宝
需授权
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| method | String | 是 | API接口名称 |
| certi_id | Number | 否 | 分配给应用的证书ID |
| from_node_id | String | 是 | API调用的来源节点ID,对于第三方开发者来说,此id即为申请应用颁发的APP KEY |
| from_api_v | String | 否 | 请求方版本号 |
| to_node_id | String | 否 | API调用的目的节点ID(除了基础服务类api,其他接口必传此参数) |
| to_api_v | String | 否 | 接收方版本号 |
| callback_url | String | 否 | 响应回调地址,带http路径的标准URL。(调用异步接口此参数必填) |
| v | String | 是 | 矩阵API协议版本,可选值:1.0 |
| timestamp | String | 是 | 时间戳,格式为yyyy-MM-dd hh:mm:ss,例如:2008-01-25 20:23:30。ShopEx API服务端允许客户端请求时间误差为10分钟 |
| format | String | 是 | 可选,指定响应格式。默认JSON ,目前支持格式为JSON |
| sign | String | 是 | 对调用API时所有输入参数(包括应用级参数)进行签名结果 |
| 名称 | 类型 |
|
示例值 | 默认值 | 描述 |
|---|---|---|---|---|---|
| coupon_id | Number |
淘宝(可选) |
123456 |
优惠券的id |
|
| buyer_nick | String |
淘宝(可选) |
zhangsan |
买家昵称 |
|
| state | String |
淘宝(可选) |
unused |
优惠券使用情况,可选值:unused(未使用),using(使用中),used(已使用) |
|
| page_no | String |
淘宝(可选) |
1 |
1 |
查询的页号,结果集是分页返回的,每页20条 |
| page_size | String |
淘宝(可选) |
20 |
20 |
每页行数,默认20 |
| 名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
| coupon_details | CouponDetail[] | 是 | 返回优惠卷详情 |
{
"rsp":"succ",
"msg_id":"3463421b2581604c74dcb9b74ffab2e4"
"data":{
"total_results": 10,
"coupon_details":{
"coupon_detail":[{
"buyer_nike": "张三",
"channel": "rewardforgifts",
"state": "Unused"
}]
}
}
}
| 错误码 | 错误描述 | 解决方案 |
|---|