检测商品实体砍价活动状态接口(ver 20160830

检测商品实体砍价活动状态接口

主要应用场景:商品详情页面中,点击砍价活动按钮时调用,判断选中的商品实体是否开启砍价活动状态

接口调用请求说明

http请求方式: POST,GET 
接口地址: /api/bargain/CheckEntity

参数说明

参数 是否必须 说明 版本号
geId 商品实体id 20160830
num 数量 20160830

调用举例

$.ajax({
	type: "POST",
	url: "/api/bargain/CheckEntity",
	data: "geid=" + $("#hdGoodsEntitys").val() + "&num=" + $("#txtCount").val(),
	async: false,
	dataType: "json",
	success: function (data) {
	}
});

返回说明

正常情况下,会返回商品实体的相关信息:

{
	"ret": "Ok",--状态,Ok为成功
	"data": {--返回数据
		"geId": 21,--商品实体Id
		"gId": 12,--商品Id
		"num": 3,--商品实体数量
		"gesm": [
			{
				"goodsEntitys": 512,--商品实体Id
				"specifications": 25,--属性规格Id
				"specificationsName": "尺寸",--属性规格名称
				"specificationsType": 0,--属性类型:0 文字类型 1 图片类型
				"specificationsValue": 25,--属性规格值Id
				"specificationsValueName": "M",--属性规格值名称
				"specificationsValueImage": ""--属性规格图片地址
			}
		],
		"bottomPrice": 1.00,--活动最低价(单品)
		"salePrice": 89.22,--商品售价(单品)
		"bottomTotal": 3.00,--活动最低价(总价)
		"TotalPrice": 211.22,--活动总价
		"bargainTimes": 5,--最低砍价次数
		"activityTimes": 3,--活动有效时间数量
		"activityUnit": "minute",--活动有效时间单位
		"VaildTime": "3分钟",--活动有效时间显示字段
		"uId": 521--用户Id
	}
}

错误时状态码不会是1000,JSON数据包示例如下(该示例为参数错误):

{
	"ret": "-1002",--已有活动正在进行中
	"data": {--返回数据
		"id": 12,--已有砍价活动Id
		"goodId": 12,--商品Id
		"entityId": 12,--商品实体Id
		"salePrice": 56.22,--商品售价
		"bottomPrice": 2.30,--活动最低价
		"bargainTimes": 12,--最低砍价次数
		"num": 12,--商品实体数量
		"curPrice": 78.32,--当前价格
		"userId": 12,--活动所属用户id
		"state": 1,--活动状态,0为正常开启,1为活动结束
		"createTime": "2016/08/24 10:55:34",--创建时间
		"endTime": "2016/08/24 10:55:34"--结束时间
	}
}

其他的ret码:
1001:参数不全
1002:库存不足
1003:用户未登陆
-1001:砍价活动没开启