store.promotion.coupondetail.get 通过接口可以查询某个店铺优惠券的买家详细信息返回的信息,买家昵称, 使用渠道,使用状态,总数量 (同步)

详细描述

通过接口可以查询某个店铺优惠券的买家详细信息返回的信息,买家昵称, 使用渠道,使用状态,总数量

支持平台: 淘宝

API用户类型授权

需授权

系统级别输入参数

名称 类型 是否必须 描述
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[]

返回优惠卷详情

XML数据格式:

			
JSON数据格式:
{
    "rsp":"succ",
    "msg_id":"3463421b2581604c74dcb9b74ffab2e4"
    "data":{
      "total_results": 10,
      "coupon_details":{
       "coupon_detail":[{
        "buyer_nike": "张三",
        "channel": "rewardforgifts",
        "state": "Unused"
       }]
      }
    }
}

错误码

错误码 错误描述 解决方案

FAQ

修改时间:2012-06-18 15:09:21