淘宝客高级API
淘宝客转链api(万能转链-新版-点卡版)
需要授权 需要点卡
2346人使用 查看优惠

支持商品id、商品链接、会场id

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

material

String

https://s.click.taobao.com/pQBDhNu,https://s.click.taobao.com/pQBDhNu

物料,可以为url或淘口令

seller_id

String

卖家ID

item_id

String

qYtxrMJOC8tmtM-Qq0Z65Sbbq5DqZ9

商品id

page_id

String

会场id

relation_id

String

渠道管理ID

pid

String

推广位mm_开头

返回参数说明

标记

类型

例子

说明

promotion_info_dto

PromotionInfoDTO

营销信息

commission_rate

String

6.00

佣金率

coupon_info_dto

CouponInfoDTO

券信息

coupon_end_time

String

2022-12-20 23:59:59

优惠券结束时间

activity_id

String

19d114f1a6464c98a30b01b3cb17dad6

券ID

coupon_remain_count

Number

99944

优惠券剩余数量

coupon_amount

String

80.00

券面额

coupon_start_time

String

2022-12-14 00:00:00

优惠券开始时间

coupon_desc

String

满129元减80元

优惠券信息,满XX元减XX元

coupon_type

Number

0

0-店铺 1-单品

link_info_dto

LinkInfoDTO

链接信息

coupon_long_url

String

二合一长链接

material_type

Number

1—单品 2—店铺 3—会场 4-承接开放 5-优惠券

tpwd_origin_url

String

淘口令原始链接,入参物料不为淘口令时,此字段返回null

material_id

String

688401422805

物料ID,需根据material_type判断物料类型, 可能为商品ID、卖家ID、会场ID

cps_long_url

String

CPS链接长链

cps_short_tpwd

String

CPS链接的短口令

tk_biz_type

Number

2

1-联盟口令,2-主站口令。入参物料不为淘口令时,此字段返回null

coupon_short_tpwd

String

二合一链接的短口令

cps_short_url

String

CPS链接短链

coupon_short_url

String

二合一链接长链

coupon_full_tpwd

String

二合一链接的长口令

cps_full_tpwd

String

CPS链接的长口令

shop_url_list

ShopUrlList[]

铺转链结果

event_url_list

EventUrlList[]

活动转链信息

item_url_list

ItemUrlList[]

单品转链信息

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "event_url_list": [],
        "item_url_list": {
            "item_url_list": [
                {
                    "coupon_info_dto": {
                        "activity_id": "9933b8055cc54697836b1c95804c6bcc",
                        "coupon_amount": "10.00",
                        "coupon_desc": "满39元减10元",
                        "coupon_end_time": "2024-01-01 23:59:59",
                        "coupon_remain_count": 971134,
                        "coupon_start_time": "2023-12-01 00:00:00"
                    },
                    "link_info_dto": {
                        "coupon_full_tpwd": "29¥ CZ0001 MNGIWgyTTaA¥ https://m.tb.cn/h.5nT5LK1  冬季男鞋2023新款加绒保暖加厚棉鞋男士运动防滑工装马丁劳保潮鞋",
                        "coupon_long_url": "https://uland.taobao.com/coupon/edetail?e=19gSoRuzAZOlhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWgpcJRl3wFwcV%2FlEyhmp8C%2FkrNlSolEFJZ6CSTeIMhW0MDgkvoDWVNCErJ4G34AddB%2BJ3ANGROKsiCgwiHozLAx3QmMbWkjeiTsFs8hRhSM%2FuvuI92sOE3NpBWnthgP3bEXBNMJ3BgqOHpcnQT9ttly1vmZRkDvoB55pVu4YJmiWbKNV%2Bj2e7ES1k0LIVPLzrWIIgVZ05WVggfJBfHCFr1CrIfPkAz9tMS1tTOw7i0ks3dCCzJpnfP1F5gk7F5gQo2AFcFiDPtVSB9Oxyt7%2BcCqe%2BSu%2F8jq%2BCUzVkkdwsIm&traceId=210761d317034861558397481e2958&&union_lens=lensId:TAPI@1703486155@21500a60_0d2f_18c9fafeca5_5eba@01",
                        "coupon_short_tpwd": "¥MNGIWgyTTaA¥",
                        "coupon_short_url": "https://s.click.taobao.com/5VNns2u",
                        "cps_full_tpwd": "19¥ CZ0001 pHxcWgyTTG5¥ https://m.tb.cn/h.5ofEXfy  冬季男鞋2023新款加绒保暖加厚棉鞋男士运动防滑工装马丁劳保潮鞋",
                        "cps_long_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DfAEiJ6b0Vd5w4vFB6t2Z2ueEDrYVVa64yK8Cckff7TVRAdhuF14FMfm1GsjzDDZU5x%2BIUlGKNpUxnzm7RurvT%2FIyEWtIUaUGG8VZNgwgNp5k5%2FOMfVn0VTpRpDJK%2FklFGJlBrlWZ9LniUwyAaK%2FX9xz9D7Ssr2pmotYzDcQ4SzJ6LYHezV0cv9zqaScLeXrYbV8hGCvTILCaq4e5TNhmprEkuRpM%2BYL5G02VG1xd4KxdOrXURUbMQ7CRXCzwAW8SqEE%2BtWqyOOiaHTptosNIBNkYvQZuIwx3ynC%2Bk5yZsTooxy6aoZznQgiV2Fzc%2F%2FerJ0JnykB5J2TGDmntuH4VtA%3D%3D&union_lens=lensId:TAPI@1703486155@21500a60_0d2f_18c9fafeca5_5eba@01",
                        "cps_short_tpwd": "¥pHxcWgyTTG5¥",
                        "cps_short_url": "https://s.click.taobao.com/dAEns2u",
                        "item_id": "Pyk2890s3t6DKp9pZYuxzXIPt6-rk9myqsMMKyao0jCX",
                        "material_type": 1
                    },
                    "promotion_info_dto": {
                        "commission_rate": "0.90"
                    }
                }
            ]
        },
        "material_url_list": [],
        "shop_url_list": []
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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