接口使用场景等说明:【特别公告】
抖音精选联盟官方平台于3月13日关闭,请参考 https://www.veapi.cn/gonggao/detail_84.html
做为平替,将由穿山甲接口替代,佣金直接在本站会员中心结算。
详情见穿山甲API说明 https://www.veapi.cn/apidoc/douyindouke/369
本接口适用于入参数为抖口令或短链的场景,比如别人的推广链接。
接口可以解析、转链以下各类型的抖客口令或短链的场景转链:
1、商品, 2、直播间,3、直播预告,4、活动页,5、抖客红包,6、商品优惠。
接口可以直接解析入参。不需要再解密。
注意:
本接口不支持明文商品链接或ID,比如https://haohuo.jinritemai.com/views/product/detail?id=351074636559038,这类入参请使用“商品转链接口”。
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/douke/douke_powershare | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
command | String | 是 | https://v.buydouke.com/UQ7bYWo/ | 抖口令或短链,不支持商品ID明文链。 |
pid | String | 否 | dy_123_233_2222 | 达人和抖客的PID,可以会员中心设置默认值后不需要传参。 |
external_info | String | 否 | 111_222 | 跟单用途字段,自定义值,只允许数字、字母和_,限制长度为40,下单后将在订单接口中透出。 |
platform | Int32 | 否 | 0 | 回流端标识 0:抖音 1:抖音极速版 |
need_dkl_str | Int32 | 否 | 1 | 默认0,可选值1,是否需要抖口令中的口令纯字母和数学字串。如果想要口令ё8NYMAvB4XgE8ξ中的“8NYMAvB4XgE8”部分,方便自行再匹配成其它形式的口令,就指定本参数为1, 返回值增加一个字段dkl_str保存了该口令核心字符串。 |
detail | Int32 | 否 | 默认0或不填 | 是否返回更详情商品信息,可选1,2,3,4返回更完整商品介绍字段(推荐3,可返回普通佣金和正常佣金kol_cos_ratio字段)。可选值1-4分别对应不同的详情字段类型: 1-对应免授权详细版;2-对应免授权简要版;3-对应达人版详细版;4-对应达人版详细版; |
access_token | String | 否 | 7002 | 多用户专用。如果您的会员卡是多用户版订单查询接口,若要查不同的帐号,请提供该帐号授权的sessionkey值 |
account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id数据,联盟号ID请到会员中心授权页查看 |
GET/POST http://api.veapi.cn/douke/douke_powershare?vekey=xxx&command=https://v.buydouke.com/UQ7bYWo/【例子】解析口令
http://api.veapi.cn/douke/douke_powershare?vekey=xxx&command=2:/ 长按複➕ ©此条消息,咑揩ƿȎƱȳɫǸ瞍索,查看商品详情ξrkSamOpk9WC8ÄÄ(请urlencode)
$api="http://api.veapi.cn/douke/douke_powershare?vekey=xxx&command=https://v.buydouke.com/UQ7bYWo/"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $api); //curl_setopt($ch, CURLOPT_POST, true); //POST方式时启用 //curl_setopt($ch, CURLOPT_POSTFIELDS, $postData ); //POST方式时传参 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); //如果使用https请启用 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true ); //返回数据流,不直接输出 curl_setopt($ch, CURLOPT_ENCODING, 'gzip'); //使用gzip压缩传输让访问更快 curl_setopt($ch, CURLOPT_TIMEOUT, 6); //允许执行的最长秒数。这里设定6S curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); $result = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); echo $result; //返回值
import cn.hutool.http.HttpResponse; import cn.hutool.http.HttpRequest; public class testGetParam { public static void main(String[] args) { // API网址 String url = "http://api.veapi.cn/douke/douke_powershare?vekey=xxx&command=https://v.buydouke.com/UQ7bYWo/"; // JDK 8u111版本后,若目标页面为HTTPS协议,请启用proxy用户密码鉴权 //System.setProperty("jdk.http.auth.tunneling.disabledSchemes", ""); // 发送请求 String result = HttpRequest.get(url) .timeout(10000)//设置超时,毫秒 .execute().body(); System.out.println(result); } }
import requests # 要访问的API网页 target_url = "http://api.veapi.cn/douke/douke_powershare?vekey=xxx&command=https://v.buydouke.com/UQ7bYWo/" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
command_type | Int16 | 1 | 口令类型 1:商品 2:直播间 3:直播预告 4:活动页 5:抖客红包 6:商品优惠 |
product_info | Struct | - | 商品信息,command_type为1或6返回该项 |
└─ product_id | Int64 | 123456 | 商品ID |
└─ ins_activity_param | String | abc | 团长参数 |
└─ share_info | Struct | - | 转链分享物料 |
└─ deeplink | String | snssdk1128://ec_goods_detail/?promotion_id=3471556980941674&kol_id=99575927 | deeplink |
└─ share_command | String | 长按覆[呲牙]zhi此条消息,咑[玫瑰]搜[烟花],查看商品详情Ig9FOHrrl8ηη | 抖口令 |
└─ zlink | String | https://z.douyin.com/xxxxxxx | Zlink,允许外部APP直接唤起抖音直播间,未安装抖音应用用户,唤起抖音下载页,有效期60天 |
└─ share_link | String | https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id= | 商品站外H5链接 |
└─ dkl_str | String | 8NYMAvB4XgE8 | 抖口令去除两边各类符号后的核心字符串,方便自行再匹配抖口令形式。只有指定need_dkl_str=1入参,才返回本参数。 |
└─ qrcode | Struct | - | 二维码 |
└─ url | String | https://p3.douyinpic.com/img/aweme-qrcode/PqFhya700510763792421~c5_360x360.webp?from=1723184 | 图片地址 |
└─ width | Int32 | 360 | 宽度 |
└─ height | Int32 | 360 | 高度 |
live_info | Struct | - | 直播间信息,仅command_type为2返回该项 |
└─ author_buyin_id | String | 112233 | 主播百应ID |
└─ product_id | Int64 | 123456 | 直播间绑定的商品ID,product_id专属于该直播间,可能已经失效 |
└─ share_info | Struct | - | 转链分享物料 |
activity_info | Struct | - | 活动页信息,仅command_type为4返回该项 |
└─ material_id | Int64 | 123456 | 活动物料ID |
└─ extra_params | String | {"product_id":"12345678"}" | 活动页自定义参数,对应活动页转链接口的同名参数 |
└─ share_info | Struct | - | 转链分享物料 |
redpack_info | Struct | - | 抖客红包信息,仅command_type为5返回该项 |
└─ redpack_id | String | 123456 | 抖客红包ID |
└─ share_info | Struct | - | 转链分享物料 |
detail商品详情字段 | Struct | - | 更多商品详情字段,请参考商品详情接口 |
{ "error": "0", "msg": "查询成功!", "data": { "command_type": 1, "product_info": { "ins_activity_param": null, "product_id": 3613112615326349680, "share_info": { "deeplink": "snssdk1128://lynxview?surl=https%3A%2F%2Flf-dy-sourcecdn-tos.bytegecko.com%2Fobj%2Fbyte-gurd-source%2F1325%2Fgecko%2Fresource%2Ffe_lynx_distribution_landing%2Fapp%2Ftemplate.js&hide_nav_bar=1&hide_status_bar=1&token=UqAsEm6&distribution_ab=1", "qrcode": { "height": 360, "url": "https://p6.douyinpic.com/img/aweme-qrcode/UiBkyA7241515874606237480~c5_360x360.webp?from=2510469333", "width": 360 }, "share_command": "33.:/ 长按覆zhi此条消息,哒剀ɗȎƲϔɫǹ瞍索,查看商品详情ξ10acI6p9DdWC8ππ", "share_link": "https://v.buydouke.com/UqAXvUW/", "zlink": "https://z.douyin.com/0MhY1Np" } } }, "dk_logid": "202306061820313A642A0C1EBBAD4D00BA", "request_id": "HblvHQD" }