全网转链接口说明

全网万能转链接口主要是用于统一处理“淘宝联盟、拼多多、唯品会、京东联盟、抖音精选联盟（抖客）”等电商平台的转链。

一、使用场景

主要是用于微信机器人查券。

APP上的查券亦可使用。

二、接口用途

当用户从淘宝或京东等APP上获得一个分享淘口令或链接。发到你的微信机器人上，您需要判断这段内容是来自哪一个电商平台并输出对应的返利和券信息。绝大部分的机器人只查淘宝平台。因此可能会错失成交机会。本接口就是为了简化这个用途。

三、入参说明

由于是整合淘宝联盟、拼多多、唯品会、京东联盟等全网电商平台，因此，接口简化了传参的数量，也简化了每个平台的转链接口返回字段的差异，对返回值做统一的处理。

在调用接口时，除了文档规定的参数以外，你可以使用维易对每个平台的转链接口专有的参数，比如你可以传入淘宝联盟万能转链的渠道ID参数relationId。

必要的入参：

（1）para参数：

接受“淘口令、各平台的链接”，不接收文字类搜索。请urlencode编码后传参。

（2）PID类：

A.使用pid指定淘宝联盟的PID参数。

B.使用vip_pid指定唯品会的PID参数。

C.使用pdd_pid指定拼多多的PID参数（可搭配PID关联的custom_parameters参数）。

D.使用dk_pid指定抖客的PID参数。

E.使用unionid和positionId指定京东的联盟ID和PID。

（3）授权SESSIONKEY值：

A.使用sessionkey指定淘宝联盟的授权值。

B.使用vip_sessionkey指定唯品会授权值。

C.使用pdd_sessionkey指定拼多多的授权值。

D.使用jd_sessionkey指定京东的授权值。

E.使用dk_sessionkey指定唯品会的授权值。

示例：

http://api.veapi.cn/global/unionhc?vekey=xxx&para=https://p.pinduoduo.com/4IrAUZUi&unionId=2103034552&positionId=&pid=&vip_pid=&pdd_pid=4079456_34211517&custom_parameters=6688

四、返回值说明：

接口对出参字段做了统一处理，只返回必要的字段，用于展示必要的信息。

{

    "error": "0",

    "msg": "全平台转链成功，本次结果为拼多多（多多进宝）转链！",

    "plat_type": 2,   // 指定是哪一个平台的：1-淘宝联盟，2-拼多多，3-京东，4-唯品会，5-抖客精选联盟

    "plat_name": "拼多多",

    "data": {

        "title": "毕生之研咖啡减淡唇纹唇霜滋润保湿去死皮防干裂唇膜唇膏唇部精华", //产品标题

        "shop_name": "毕生之研官方旗舰店",   //店铺名称

        "item_id": "392148525804",   //商品ID

        "price": "73",   //折后价

        "main_pic": "https://img.pddpic.com/...a.jpeg", //主图

        "commission_rate": "18.90",  //佣金，百分值

        "prom_url": "https://p.pinduoduo.com/ndrALq2L",   //推广链接

        "coupon_info": {   //优惠券信息

            "coupon_start_time": "2022-12-08 00:00:00",  //优惠券开始使用时间

            "coupon_end_time": "2022-12-11 23:59:59",  //优惠券结束时间

            "coupon_remain_count": "9000",  //优惠券余量

            "coupon_total_count": "10000",  //优惠券总量

            "coupon_info": "满24元减24元",

            "coupon_amount": "24",  //优惠券面额

            "coupon_start_fee": "24"  //优惠券起用条件

        },

        "hascoupon": 1   //是否有券，0-无，1-有

    },

    "request_id": "lRgkUSP"

}

如果您有需要其它字段，可以联系我们。

本接口还需要完善，欢迎提供建议，谢谢！