淘宝客高级API
淘宝商品优惠券查询/猫超券/私有券接口
需要授权
1122人使用

该接口优先查询店铺私有券、猫超券,如果没有就返回商品券。

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

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

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

参数接口

参数类型

必填

示例

说明

apikey

string

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

id

Number

商品ID

返回参数说明

标记

类型

例子

说明

coupon

String

15

优惠券金额

activity_id

String

6e81dfe8231d42aeb1bb5f51b8d8976b

券id

surplus

Number

1234

券剩余量

receive

Number

22

已领取数量

end_time

Date

2019-05-06

券到期时间

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "coupon": "15",
        "activity_id": "6e81dfe8231d42aeb1bb5f51b8d8976b",
        "surplus": 44400,
        "receive": 15600,
        "end_time": "2019-05-06"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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