获取店铺下所有优惠券信息
需要点卡
3162人使用 查看优惠

根据商品id获取商品对应店铺内所有优惠券信息,如果商品没有加入淘宝推广,还需要提供店铺 seller_id

接口地址: http://api.tbk.dingdanxia.com/shop/coupon_list 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

id

Number

商品ID

seller_id

Number

如果商品没有被商家开通淘客推广,就需要提供seller_id

返回参数说明

标记

类型

例子

说明

coupon_start_fee

String

29.00

优惠券门槛金额

coupon_remain_count

Number

1000

优惠券剩余量

coupon_total_count

Number

3000

优惠券总量

coupon_end_time

Date

2019-08-17

优惠券结束时间

coupon_start_time

Date

2019-09-17

优惠券开始时间

coupon_amount

Number

10.00

优惠券金额

coupon_src_scene

Number

1

券类型,1 表示全网公开券,4 表示妈妈渠道券

coupon_type

Number

0

券属性,0表示店铺券,1表示单品券

coupon_activity_id

String

c5d72c8879ad432bbc840d3c489c4fed

券ID

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": [
        {
            "coupon_activity_id": "d968d718f99a42de848d6952d8030b79",
            "coupon_amount": "2.0",
            "coupon_end_time": "2020-05-31",
            "coupon_remain_count": 95720,
            "coupon_src_scene": 1,
            "coupon_start_fee": "59.0",
            "coupon_start_time": "2020-04-10",
            "coupon_total_count": 100000,
            "coupon_type": 0
        },
        {
            "coupon_activity_id": "18e04b0cfd1e4fd290a2af94f1b12c34",
            "coupon_amount": "3.0",
            "coupon_end_time": "2020-05-31",
            "coupon_remain_count": 47700,
            "coupon_src_scene": 1,
            "coupon_start_fee": "100.0",
            "coupon_start_time": "2020-04-10",
            "coupon_total_count": 50000,
            "coupon_type": 0
        },
        {
            "coupon_activity_id": "e018c2b49fb045d98f9ab319d92c0d18",
            "coupon_amount": "5.0",
            "coupon_end_time": "2020-05-31",
            "coupon_remain_count": 48772,
            "coupon_src_scene": 1,
            "coupon_start_fee": "200.0",
            "coupon_start_time": "2020-04-10",
            "coupon_total_count": 50000,
            "coupon_type": 0
        },
        {
            "coupon_activity_id": "d92cd4c445af493cb55b0ae16b83bc52",
            "coupon_amount": "10.0",
            "coupon_end_time": "2020-05-31",
            "coupon_remain_count": 49159,
            "coupon_src_scene": 1,
            "coupon_start_fee": "300.0",
            "coupon_start_time": "2020-04-10",
            "coupon_total_count": 50000,
            "coupon_type": 0
        },
        {
            "coupon_activity_id": "7c74d8e505ae46bd95f15988ab724c9b",
            "coupon_amount": "15.0",
            "coupon_end_time": "2020-05-31",
            "coupon_remain_count": 49396,
            "coupon_src_scene": 1,
            "coupon_start_fee": "450.0",
            "coupon_start_time": "2020-04-10",
            "coupon_total_count": 50000,
            "coupon_type": 0
        },
        {
            "coupon_activity_id": "60f83e6c09e74299bfd43ad9cb05ee24",
            "coupon_amount": "20.0",
            "coupon_end_time": "2020-04-30",
            "coupon_remain_count": 4172,
            "coupon_src_scene": 1,
            "coupon_start_fee": "600.0",
            "coupon_start_time": "2020-04-01",
            "coupon_total_count": 5000,
            "coupon_type": 0
        }
    ]
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。