淘口令解析api接口(加强版,支持所有口令)
需要点卡
13668人使用 查看优惠

将淘口令解析还原成url,商品口令、券口令可完美解析出商品id;

目前支持的口令类型有:商品口令、二合一优惠券口令、聚拼团商品口令、淘礼金领券口令.... 

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

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

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

tkl

String

淘口令,支持传入包含口令的整个文案

返回参数说明

标记

类型

例子

说明

num_iid

Number

12345678

商品id, 只要口令是商品口令或券口令时才返回商品id

content

String

宝贝xxxxx

淘口令-文案

title

String

宝贝xxxxx

商品标题

price

String

90.00

商品价格(手淘分享的口令,才可以解析出价格)

pic_url

String

https://img.alicdn.com/tfs/TB1J1sjJFXXXXaHXVXXXXXXXXXX-242-90.png

口令图片

url

String

https://uland.taobao.com/coupon/edetail?e=jTS9Uk507ZQG

跳转url(长链)

native_url

String

tbopen://m.taobao.com/tbopen/index.html?a.....

移动端调起地址

thumb_pic_url

String

https://img.alicdn.com/tfs/TB1J1sjJFXXXXaHXVXXXXXXXXXX-242-90.png thumbPicUrl

缩略图

material_type

Number

1

1—商品 2—店铺 3—会场 4-承接开放 5-优惠券 6-直播间

tpwd_origin_url

String

入参口令/链接对应的原链接

tk_biz_type

Number

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

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "material_id": "6bNrnQRC8tyqZY9h8pfot3-qKD36ROtnv7X6nV0c7w",
        "material_type": 1,
        "tk_biz_type": 1,
        "tpwd_origin_url": "https://uland.taobao.com/coupon/edetail?traceId=2104504017404673768061224e243a&e=zj%2Fsm5FDeqilhHvvyUNXZfh8CuWt5YH5OVuOuRD5gLJMmdsrkidbOWBzzpT26idJWJOcDU6WYmp3OTZKiJUNVXq6oIahu2bP6qmX9oLhqBL12XJs7BCTDv69xPqhSeWzunJRB6s4D3jyMW3eIAWKRa6LeGhgJY%2B%2F8vrq94OcQ6BRFm1W0zBdFCquke10xPxN8pkyJgcFQeJ1xWWiZA1vGao4yqclMoZyHov%2Bo0KkfE2Ur3wUnOKqF%2BNMK6FZpp6Zp6po9pfw9xqyvw5TbGyNhtka0HB5eu0hSeRIf0bpd%2F8SzkZzi9uL2zizYPfw0LoNN5328u5juoZ%2BOHfs5nLQGA%3D%3D&union_lens=lensId%3ATAPI%401740467376%4021365ea6_0d69_1953bf092e9_1a76%40026J364ziFIZW4xXgNM8wY8c&un=a6738c84392d1efa4b68d5f77a161062&share_crt_v=1&un_site=0&ut_sk=1.utdid_null_1740467376925.TaoPassword-Outside.taoketop&spm=a2159r.13376465.0.0&sp_tk=UGdOZ2VRZlJzaVk%3D&bxsign=tcd3ZvFQGBI6UsTmhLdvqS75bxrvShzR6RL-mUPaTaM4gMGr8MA1tdZoHrPX6v2axjECBtYg2dbBYp4ofx3_oLvYEx6kSrXXcxoJm1RiZ4IzCQ&bc_fl_src=share-707482327860-1-0",
        "num_iid": "6bNrnQRC8tyqZY9h8pfot3-qKD36ROtnv7X6nV0c7w",
        "url": "https://uland.taobao.com/item/edetail?id=zD9Yn9NMietaxmDMnvzUvDyfVU4-X6WQkrt0Xw3n0BKUwx",
        "content": "东北黄糯玉米棒新鲜软糯香甜粘黏苞米白糯黑糯真空装包装早餐速食",
        "title": "东北黄糯玉米棒新鲜软糯香甜粘黏苞米白糯黑糯真空装包装早餐速食",
        "price": "29.9",
        "pic_url": "https://img.alicdn.com/bao/uploaded/i4/2215656572864/O1CN01hwzjx61X1lLzc6iZh_!!4611686018427381696-0-item_pic.jpg",
        "thumb_pic_url": "https://img.alicdn.com/bao/uploaded/i4/2215656572864/O1CN01hwzjx61X1lLzc6iZh_!!4611686018427381696-0-item_pic.jpg"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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

4015

系统异常

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

4017

请求拒绝

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