淘口令解析api接口(加强版)
需要点卡
8364人使用

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

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

接口地址: http://api.tbk.dingdanxia.com/tkl/query 在线测试
请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

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

signature

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

缩略图

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "content": "FANBIYA X8隐形蓝牙耳机无线迷你超小挂耳式运动开车入耳塞微型头戴式可接听电话手机男女通用适用苹果",
        "native_url": "tbopen://m.taobao.com/tbopen/index.html?a.....",
        "pic_url": "https://img.alicdn.com/tfscom/i2/2289894494/O1CN01IFLHLJ1j4IOYvfX3g_!!0-item_pic.jpg",
        "suc": true,
        "thumb_pic_url": "https://img.alicdn.com/tfscom/i2/2289894494/O1CN01IFLHLJ1j4IOYvfX3g_!!0-item_pic.jpg_170x170.jpg",
        "title": "淘口令-页面",
        "url": "https://uland.taobao.com/coupon/edetail?e=jTS9Uk507ZQG.......",
        "request_id": "88gbusl7o1at",
        "num_iid": "572096814881"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

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

4003

参数不正确

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

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

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

4009

点卡已用完

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

4010

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

需充值次数包

4011

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

需充值次数包

4012

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

将ip加入白名单

4013

联盟账号授权已过期

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

4014

PID异常

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