# 单品券高效转链

# 接口名称

taobao.tbk.privilege.get

# 调用方法

https://api.taobaokeapi.com/?usertoken=[usertoken]&method=taobao.tbk.privilege.get

# 请求参数

名称 类型 必须 示例值 描述
item_id Number false 123 淘客商品id
adzone_id Number true 123 推广位id,mm_xx_xx_xx pid三段式中的第三段
platform Number false 1 1:PC,2:无线,默认:1
site_id Number true 1 备案的网站id, mm_xx_xx_xx pid三段式中的第二段
me String false m%3D2%26s%3D94BYV45NHwgcQipKwQzePOeEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67pL2V8ikcqW7FfrEfJ4hp2q5rze35H1YEElKMSinFVD02hfsaefZn7H4%2Ff3V 营销计划链接中的me参数
relation_id String false 23223 渠道关系ID,仅适用于渠道推广场景
special_id String false 23223 会员运营ID
external_id String false 23223 淘宝客外部用户标记,如自身系统账户ID;微信ID等

# 响应参数

名称 类型 示例值 描述
result RpcResult 1 result
data MaterialDto 1 data
category_id Number 1 后台一级类目
coupon_click_url String https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1 商品优惠券推广链接
coupon_end_time String 2016-09-26 优惠券结束时间
coupon_info String 满16元减10元 优惠券面额
coupon_start_time String 2016-09-25 优惠券开始时间
item_id Number 524136796550 商品id
max_commission_rate String 20.3 佣金比率(%)
coupon_total_count Number 8000 优惠券总量
coupon_remain_count Number 6859 优惠券剩余量
mm_coupon_remain_count Number 1997 妈妈优惠券剩余量
mm_coupon_total_count Number 2000 妈妈优惠券总量
mm_coupon_click_url String https://uland.taobao.com/coupon/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1 商品妈妈优惠券推广链接
mm_coupon_end_time String 2017-10-13 妈妈优惠券结束时间
mm_coupon_start_time String 2017-08-10 妈妈优惠券开始时间
mm_coupon_info String 满20元减15元 妈妈优惠券面额
coupon_type Number 1 优惠券(商品优惠券推广链接中的券)类型,1 公开券,2 私有券,3 妈妈券
item_url String https://s.click.taobao.com/t?spm=a2e2e.10720394/c.90202110.1.4399704cUUhhH0&e=m%3D2%26s%3D0NJS731SUEdw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67uIA4kDYDopEpOjgxi0uT208hw4H8GMUew7uoRPWrIBwR7CIpaNCoiKr9WTFywb%2BCtGNFs53xi4QGSKqJrqeJvt5ArodCWjzv9fsai3uVirbXH%2BQH9e66Y4%3D 商品淘客链接
min_commission_rate String 20.8 入参special_id、relation_id、external_id时,该字段展示预估最低佣金率(%)

# 响应示例

{
    "tbk_privilege_get_response":{
        "result":{
            "data":{
                "category_id":1,
                "coupon_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1",
                "coupon_end_time":"2016-09-26",
                "coupon_info":"满16元减10元",
                "coupon_start_time":"2016-09-25",
                "item_id":524136796550,
                "max_commission_rate":"20.3",
                "coupon_total_count":8000,
                "coupon_remain_count":6859,
                "mm_coupon_remain_count":1997,
                "mm_coupon_total_count":2000,
                "mm_coupon_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=nqUNB1NOF3Bt3vqbdXnGloankzPYmeEFkgNrw6YHQf9pZTj41Orn8MwBAs06HAOzqQomYNedOiHDYPmqkFXqLR0HgBdG%2FDDL%2F1M%2FBw7Sf%2FesGXLf%2BqX4cbeC%2F2cR0p0NlWH0%2BknxpnCJJP%2FQkZSsyo1HvKjXo4uz&pid=mm_26381042_12970066_52864659&af=1",
                "mm_coupon_end_time":"2017-10-13",
                "mm_coupon_start_time":"2017-08-10",
                "mm_coupon_info":"满20元减15元",
                "coupon_type":1,
                "item_url":"https:\/\/s.click.taobao.com\/t?spm=a2e2e.10720394\/c.90202110.1.4399704cUUhhH0&e=m%3D2%26s%3D0NJS731SUEdw4vFB6t2Z2ueEDrYVVa64LKpWJ%2Bin0XLjf2vlNIV67uIA4kDYDopEpOjgxi0uT208hw4H8GMUew7uoRPWrIBwR7CIpaNCoiKr9WTFywb%2BCtGNFs53xi4QGSKqJrqeJvt5ArodCWjzv9fsai3uVirbXH%2BQH9e66Y4%3D"
            }
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 异常示例

{
	"error_response":{
		"sub_msg":"非法参数",
		"code":50,
		"sub_code":"isv.invalid-parameter",
		"msg":"Remote service error"
	}
}
1
2
3
4
5
6
7
8

# 错误码解释

错误码 错误消息 解决方案
isp.special-campaign-error 定向计划服务异常 建议加入重试机制
isv.item-not-exist 宝贝已下架或非淘客宝贝 使用有效的item_id
isv.pid-not-correct site_id或adzone_id与登录账号不匹配 使用登录账号下的site_id与adzone_id
isv.appkey-total-limit
isv.coupon-not-exist 优惠券不存在或已过期 请输入正确的me参数
isv.me-param-not-correct me参数错误 请输入正确的me参数
0
11 非淘客宝贝 推广无佣金