维易淘客联盟接口开发文档:淘礼金解析检测

淘礼金淘口令解析解密和淘礼金有效性检测

本接口主要是用于对淘宝联盟的淘礼金淘口令或淘礼金链接,进行解析提取淘礼金信自己,以及检测淘礼金是否仍有效。

淘礼金接口提取内容:

1、淘礼金产品基本信息,包含产品标题、店铺名等。

2、淘礼金中有的优惠券信息(如果优惠券过期,则这块内容为空)。

3、提取淘礼金中的PID信息。

4、淘礼金时间、金额等信息。


一、淘礼金解密接口:

【权限】需要“淘礼金解析点卡”会员卡专用卡。

【接口】接口用法如下:

http://api.vephp.com/chkvegas?vekey=xxx&para=$bVJ5cKcM5wM$   参数para请编码后传参

【参数】

vekey:在会员中心领取试用卡或购买会员卡后,授权得到密钥。

para:淘礼金参数,接受2种参数:1.淘礼金淘口令,2.淘礼金链接

【注意】

para参数务必urlencode编码后传参。


二、淘礼金解析接口返回值:

接口返回淘礼金产品产品标题、店铺名等基本信息,以及优惠券信息(如果有优惠券的话)。以及淘礼金信息。

其中,返回值字段vegasFields是淘礼金信息,其中的status是对rightsStatus的描述,其判断方法是:

淘礼金有效情况 rightsStatus 字段值含义:

 0:正常领取, 

1:未开始领取 

2:已过领取期 

3:领取期还未到,但礼金已领完, 

5 已领过

淘礼金解析接口返回值示例:


{

    "error": "0",

    "msg": "淘礼金解析成功!",

    "data": {

        "title": "新奥尔良腌料组合蜜汁2瓶装家用烤鸡翅粉炸鸡烤肉烧烤料调料",    //标题

        "num_iid": "626858286967",

        "pict_url": "//img.al....ic.jpg",   //主图

        "small_images": [

            "//img.alicdn.com/i4......jpg",  //主图

        ],

        "user_type": 1,     //商品是否为天猫:0-淘宝集市,1-天猫

        "shop_title": "伍斯特旗舰店",    //店铺名

        "nick": "伍斯特旗舰店",   

        "seller_id": 2208760153926,  

        "category_id": "50009826",     //分类

        "pid": "mm_239940109_976150476_109724700137",   //该淘礼金的PID

        "tkRate": 160,

        "monthSellCount": "1542",

        "coupon": [],   //优惠券信息,如为空则可能券领完或商家取消券。

        "vegasFields": {

                "status": "已过领取期",   //淘礼金状态描述

                "rightsStatus": 2,   //淘礼金状态说明

                "sendStartTime": 1607875200000,   //淘礼金发放开始时间

                "pid": "mm_2399....",    //淘礼金所属淘客PID

                "priceAfterAllRights": "11.90",   //使用淘礼金后价格

                "rightsFace": "3.00",   //淘礼金使用后的金额

                "effectDateInfo": "{\"relativeDays\":1}",  //过期日期信息:领取后1天内可用

                "effectType": "RELATIVE",   //过期类型:领券后过期 RELATIVE_NATURAL

                "sendEndTime": 1608047999000   //淘礼金发放结束时间

        }

    }

}


 

客服