本接口主要是用于对淘宝联盟的淘礼金淘口令或淘礼金链接,进行解析提取淘礼金信自己,以及检测淘礼金是否仍有效。
淘礼金接口提取内容:
1、淘礼金产品基本信息,包含产品标题、店铺名等。
2、淘礼金中有的优惠券信息(如果优惠券过期,则这块内容为空)。
3、提取淘礼金中的PID信息。
4、淘礼金时间、金额等信息。
【权限】需要“淘礼金解析点卡”会员卡专用卡。
【接口】接口用法如下:
http://api.veapi.cn/tbk/chkvegas?vekey=xxx¶=$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 //淘礼金发放结束时间
}
}
}