API文档中心

热门接口:产品ID找同款全量维权查询万能转链字符串ID转换 (有API需求可联系本站)

独立抖客和达人精选联盟商品转链接口

调用权限:核心接口会员卡调用
接口使用场景等说明:

【特别公告】

抖音精选联盟官方平台于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

调用说明

本接口需要您在会员中心授权(如果多用户可传入sessionkey参数)

接口请求地址

环境 http 地址 https 地址
正式环境 http://api.veapi.cn/douke/kol_ProductShare 暂无

请求方式:GETPOST

请求参数

参数名称 参数类型 必填 示例值 描述
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请到会员中心授权页查看

请求示例

  • HTTP
  • PHP
  • JAVA
  • PYTHON
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/
使用curl函数,curl不是php原生库,需要安装才能使用

$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; //返回值
使用okhttp3/httpclient/jsoup/hutool,以hutool为例:

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);
    }
}
推荐使用 requests,支持访问http,https网页:

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

返回值(JSON)

参数名称 参数类型 示例值 描述
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" }

错误码

如果error不为0时,请点此查看错误码表格

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部