接口使用场景等说明:【特别公告】
抖音精选联盟官方平台于3月13日关闭,请参考 https://www.veapi.cn/gonggao/detail_84.html
做为平替,将由穿山甲接口替代,佣金直接在本站会员中心结算。
详情见穿山甲API说明 https://www.veapi.cn/apidoc/douyindouke/369
本接口支持精选联盟达人、抖客、独立抖客进行商品转链,通过PID和自定义参数,获取专属商品抖口令、抖音码、deeplink和zlink。
使用本接口需要在会员中心授权。多用户可自行管理用户授权并在调用接口时传入access_token参数。
注意:不要用PID跟单,接口支持自定义参数external_info,并在订单接口中回传该参数。建议PID用于区分不同的推广渠道,比如微信、QQ、网站等等。
本接口可以转链团长发出的链接,把参数productUrl传入团长链接。并设置use_coupon=true
环境 | http 地址 | https 地址 |
---|---|---|
正式环境 | http://api.veapi.cn/douke/kol_ProductShare | 暂无 |
参数名称 | 参数类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
vekey | String | 是 | V123M56 | 公共参数,接口秘钥,请在会员中心获取 |
productUrl | String | 是 | https://haohuo.jinritemai.com/views/product/detail?id=351074636559038 | 支持商品ID、URL、抖口令、短链接、团长链接。 |
pid | String | 否 | dy_123_233_2222 | 达人和抖客的PID,可以会员中心设置默认值后不需要传参。 |
external_info | String | 否 | 111_222 | 跟单用途字段,自定义值,只允许数字、字母和_,限制长度为40,下单后将在订单接口中透出。 |
need_qr_code | Bool | 否 | false | 是否需要二维码,需要会导致响应耗时增加 |
need_zlink | Bool | 否 | false | 是否需要zlink,需要会导致响应耗时增加,不填默认false。如需要可设置为need_zlink=true |
platform | Int32 | 否 | 0 | 回流端标识 0:抖音 1:抖音极速版 |
use_coupon | Bool | 否 | false | 是否返回商品惠后价领券链接(如果商品有优惠则返回,否则不返回),当productUrl传入团长专属链接时,本参数请设置为true |
need_share_link | Bool | 否 | false | 是否返回站外H5链接,默认true |
ins_activity_param | String | 否 | abc | 团长参数 |
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值,获取该参数值方法参考授权文档(授权时设置参数 platform=douke) |
account_id | String | 否 | 联盟号id | 会员中心有多个授权时,用本参数指定要查询哪一个联盟号id数据,联盟号ID请到会员中心授权页查看 |
GET/POST http://api.veapi.cn/douke/kol_ProductShare?vekey=xxx&detail=1&productUrl=3583117383482622604&pid=dy_107213597798095225100_20865_2675084869【例子】传入URL
http://api.veapi.cn/douke/kol_ProductShare?vekey=xxx&detail=1&productUrl=https://haohuo.jinritemai.com/views/product/detail?id=3583117383482622604(productUrl参数请urlencode编码)【例子】传入抖口令
http://api.veapi.cn/douke/kol_ProductShare?vekey=xxx&detail=1&productUrl=%201c长按覆zhi此条消息,瘩剀ďȌȖƔɪɳ瞍索,查看商品:/%20详情ΨΨ4XZgsuVCX4B8ㄍㄍ(productUrl参数请urlencode编码)【例子】别人分享的短链接转链
http://api.veapi.cn/douke/kol_ProductShare?vekey=xxx&productUrl=https://v.douyin.com/Ay1Q2QU/
$api="http://api.veapi.cn/douke/kol_ProductShare?vekey=xxx&detail=1&productUrl=3583117383482622604&pid=dy_107213597798095225100_20865_2675084869"; $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/kol_ProductShare?vekey=xxx&detail=1&productUrl=3583117383482622604&pid=dy_107213597798095225100_20865_2675084869"; // 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/kol_ProductShare?vekey=xxx&detail=1&productUrl=3583117383482622604&pid=dy_107213597798095225100_20865_2675084869" # 发送请求 response = requests.get(target_url) # 获取页面内容 if response.status_code == 200: print response.text
参数名称 | 参数类型 | 示例值 | 描述 |
---|---|---|---|
share_link | String | https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id= | 商品站外H5链接 |
dy_password | String | 咑[玫瑰]搜[烟花],查看商品详情Ig9FOHrrl8 | 抖口令,注意抖口令有效期一般是8天。 |
qr_code | Struct | - | 二维码,仅传参数need_qr_code=true时才有 |
└─ url | String | https://p3.douyinpic.com/img/aweme-qrcode/PqFhya700510763792421c5_360x360.webp?from=1723184 | 图片地址 |
└─ width | Int32 | 360 | 宽度 |
└─ height | Int32 | 360 | 高度 |
dy_deeplink | String | nssdk1128://ec_goods_detail/?promotion_id=3471556980941674&kol_id=99575927&so | deeplink |
dy_zlink | String | https://z.douyin.com/xxxxxxx | Zlink,允许外部APP直接唤起抖音直播间,未安装抖音应用用户,唤起抖音下载页,有效期60天 |
coupon_link | Struct | - | 优惠价推广链接 |
└─ coupon_status | Int64 | 0 | 是否有优惠价&优惠券 0有优惠券 1没有优惠券 |
└─ share_command | String | 长按覆[呲牙]zhi此条消息,咑[玫瑰]搜[烟花],查看商品详情Ig9FOHrrl8 | 口令 |
└─ deeplink | String | snssdk1128://ec_goods_detail/?promotion_id=3471556980941674 | deeplink |
└─ share_link | String | https://alliance.jinritemai.com | 站外H5领券链接 |
detail商品详情字段 | Struct | - | 更多商品详情字段,请参考商品详情接口 |
dkl_str | String | 8NYMAvB4XgE8 | 抖口令去除两边各类符号后的核心字符串,方便自行再匹配抖口令形式,再组合上两边的口令界定符即可。只有指定need_dkl_str=1入参,才返回本参数。 |
{ "error": "0", "msg": "查询成功!", "data": { "coupon_link": { "coupon_status": 1, "deeplink": null, "share_command": null, "share_link": null }, "dy_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=ADrA27m&distribution_ab=1", "dy_password": "3M长按:/ 緮墆此条消息,da幵ƊƟưƴƖƞ瞍?,查看商品详情ŠŠko4RythQX4B8▽▽", "dy_zlink": "https://z.douyin.com/ijA7m2U", "share_link": "https://haohuo.jinritemai.com/ecommerce/trade/detail/index.html?id=3583117383482622604&origin_type=product_distribution&pd_share_schema=https%3A%2F%2Fz.douyin.com%2FijA7m2U&pd_share_token=8.%3A%2F+%23%2392Z5IvDQX4B8%23%23&pd_share_appid=1128&ec_s=7bfdd0633d0580891067595b706e2e61faaec3_RanyPDnLEyBhehjepNgZ2njgdANlFEuMaGS547CEKSI%3D" }, "request_id": "f4p3ffL" }