淘宝客高佣转链API

高级接口

请求方法

接口地址：http://api.tkurl.top/privilege

返回格式：json

请求方式：get

Session获取地址：http://api.tkurl.top/authorize?appkey=

请求示例：http://api.tkurl.top/privilege?appkey=&id=淘宝商品ID&pid=mm_xxxx_xxx_xxx&session=session

请求参数说明：

名称 类型 是否必须 示例值 描述
appkey String 必填 123456 appkey
id int 必填 548113254234 淘客商品id(同时支持数字Id和字符串Id)
pid String 必填 mm_123_123_123 当前授权帐号下的PID，满足mm_xxx_xxx_xxx格式
session String 必填 授权后，再授权页面获取 。（有效期30天）
relation_id String 选填 23223 渠道关系ID，仅适用于渠道推广场景
special_id String 选填 12345 会员运营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
当不入参special_id、relation_id、external_id时，展示常规佣金率(%)
coupon_total_count
Number
8000
优惠券总量
coupon_remain_count
Number
6859
优惠券剩余量
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
商品淘客链接
ysyl_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
预售有礼-推广链接
ysyl_tlj_face
String
0.6
预售有礼-预估淘礼金（元）
ysyl_tlj_send_time
String
2019-11-10 21:59:59
预售有礼-淘礼金发放时间
ysyl_commission_rate
String
20.3
预售有礼-佣金比例（%）（ 预售有礼活动享受的推广佣金比例，注：推广该活动有特殊分成规则，请详见：https://tbk.bbs.taobao.com/detail.html?appId=45301&postId=9334376 ）
ysyl_tlj_use_start_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用开始时间
ysyl_tlj_use_end_time
String
2019-11-10 21:59:59
预售有礼-淘礼金使用结束时间
min_commission_rate
String
20.3
当入参special_id、relation_id、external_id时，该字段展示预估最低佣金率(%)
reward_info
Number
1
比价场景专用，当系统检测到入参消费者ID购买当前商品会获得《天天开彩蛋》玩法的彩蛋时，该字段显示1，否则为0
topn_info
StepRateDto
前N件佣金信息-当入参get_topn_rate=1，前N件佣金生效且最高，透出该组字段
topn_total_count
Number
3000
前N件初始总库存，当前N件佣金失效，本字段置空（失效：任务完成、时间结束、商品下架）
topn_quantity
Number
3000
前N件剩余库存，当前N件佣金失效，本字段置空
topn_start_time
Number
1937297392332
前N件佣金开始时间，当前N件佣金失效，本字段置空
topn_end_time
Number
1937297392332
前N件佣金结束时间， 当前N件佣金 失效，本字段置空
mini_program
MiniProgramDto
小程序链接(暂未对外开放)
mini_program_appid
String
xxxx
小程序APPID
mini_program_path
String
pages/halo/itemdetail/index?id=xxx&miniAppScene=xxx
小程序路径
mini_program_qrcode_url
String
xxxx
小程序码url地址

响应示例

{
    "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,
                "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",
                "ysyl_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",
                "ysyl_tlj_face":"0.6",
                "ysyl_tlj_send_time":"2019-11-10  21:59:59",
                "ysyl_commission_rate":"20.3",
                "ysyl_tlj_use_start_time":"2019-11-10  21:59:59",
                "ysyl_tlj_use_end_time":"2019-11-10  21:59:59",
                "min_commission_rate":"20.3",
                "reward_info":1,
                "topn_info":{
                    "topn_total_count":3000,
                    "topn_quantity":3000,
                    "topn_start_time":1937297392332,
                    "topn_end_time":1937297392332
                },
                "mini_program":{
                    "mini_program_appid":"xxxx",
                    "mini_program_path":"pages\/halo\/itemdetail\/index?id=xxx&miniAppScene=xxx",
                    "mini_program_qrcode_url":"xxxx"
                }
            }
        }
    }
}

异常示例

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码 错误描述 解决方案
isp.special-campaign-error 定向计划服务异常 建议加入重试机制
isv.item-not-exist 宝贝已下架或非淘客宝贝 使用有效的item_id
isv.pid-not-correct pid与登录账号不匹配 使用授权账号下的pid
isv.coupon-not-exist 优惠券不存在或已过期 请输入正确的me参数
isv.me-param-not-correct me参数错误 请输入正确的me参数
601 高佣授权到期，需重新授权 重新授权阿里妈妈帐号
602 权限到期 联系管理员开通
603 未找到用户或该用户未注册 请输入正确的appkey
604 未知参数错误 建议加入重试机制
404 参数传入错误_未知参数 检查参数类型是否正确
平台唯一技术支持QQ：2334997931