单品券高效转链(高佣API)

¥收费高级接口

请求方法

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

返回格式:json

请求方式:get

阿里妈妈授权:需要授权

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

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

请求参数说明:

名称 类型 是否必须 示例值 描述
type String 选填 1 备用接口设置
appkey String 必填 123456 appkey
id int 必填 548113254234 淘客商品id
pid String 必填 mm_123_123_123 当前授权帐号下的PID,满足mm_xxx_xxx_xxx格式
session String 必填 授权后,再授权页面获取 。(有效期30天)

注:推荐使用高佣连接时实时调用,提前转换连接易出现低佣情况。

响应参数

名称 类型 示例值 描述
category_id Number 1 后台一级类目
coupon_click_url String https://uland.taobao.com/coupon/edetail?e=xxxxxxxxx 商品优惠券推广链接
coupon_end_time String 2016-09-26 优惠券结束时间
coupon_info String 满16元减10元 优惠券面额
coupon_start_time String 2016-09-25 优惠券开始时间
item_id int 524136796550 商品id
max_commission_rate String 20.3 佣金比率(%)
coupon_total_count int 8000 优惠券总量
coupon_remain_count int 6581 优惠券剩余量
mm_coupon_remain_count int 1997 妈妈优惠券剩余量
mm_coupon_total_count int 3000 妈妈优惠券总量
mm_coupon_click_url String https://uland.taobao.com/coupon/edetail?e=xxxxxxxxx 商品妈妈优惠券推广链接
mm_coupon_end_time String 2017-10-13 妈妈优惠券结束时间
mm_coupon_start_time String 2017-08-10 妈妈优惠券开始时间
mm_coupon_info String 满20元减15元 妈妈优惠券面额
coupon_type int 1 优惠券(商品优惠券推广链接中的券)类型,1 公开券,2 私有券,3 妈妈券

响应示例

   {
    "tbk_privilege_get_response":{
        "result":{
            "data":{
                "category_id":1,
                "coupon_click_url":"https:\/\/uland.taobao.com\/coupon\/edetail?e=cJEPBfJtho8GQASttHIRqeoPsyEtjIUQxkqDm6%2BlrbByvrZzJ209kk89GSPPdaARIn1lCThcaBmD%2ByuIPB7ZA79fwBwwUiqlVFk%2FlIg7J0HYd3v6q6tpEvSs4zOlZ4se&traceId=0ab084ae15144044526938628e"",
                "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=NX%2Fo0GUzcHkGQASttHIRqbYlZkeSuQ8GiGZozHNkuvFyvrZzJ209kk89GSPPdaARIn1lCThcaBmD%2ByuIPB7ZA79fwBwwUiqlVFk%2FlIg7J0HYd3v6q6tpEm7PVn13QcLNgPRfTgnhrZM%3D&traceId=0bb75cd915144045746605710e",
                "mm_coupon_end_time":"2017-10-13",
                "mm_coupon_start_time":"2017-08-10",
                "mm_coupon_info":"满20元减15元",
                "coupon_type":1
            }
        }
    }
}
   

异常示例

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

错误码解释

错误码 错误描述 解决方案
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 参数传入错误_未知参数 检查参数类型是否正确