会员红包API对接

1、领取接口

1.1 接口地址

https://域名/app/index.php?i=1&c=entry&ctrl=system&ac=common&op=vipRedpacket&ta=index&do=mobile&m=we7_wmall&from=vue

1.2 接口参数

参数名称类型说明实例
mobileString手机号13333333333
agentidString权益ID1
signString签名

1.3 签名方式

将接口参数按照agentid=对应的值&mobile=对应的值的方式连接后,进行md5加密即可

示例:待签名字符串 agentid=1&mobile=13333333333

md5加密后字符串 aa7980680b5eb5078c77e1241dbb801e

1.4 接口请求方式

POST

Content-Type:application/x-www-form-urlencoded

1.5 请求响应

参数名称类型说明示例
errnoInt错误号0 成功 -1失败
messageString描述文字红包领取成功
data
ordersnString领取记录ID20260814103935154282
正确响应示例
{
	errno: 0,
        message: '红包领取成功',
        data: {
            ordersn: '20260814103935154282'
     }
}
错误响应示例
{
	errno: -1,
        message: '手机号不能为空' 
}

2、查询接口

2.1 接口地址

https://域名/app/index.php?i=1&c=entry&ctrl=system&ac=common&op=vipRedpacket&ta=query&do=mobile&m=we7_wmall&from=vue

2.2 接口参数

参数名称类型说明实例
ordersnString领取记录ID20260814103935154282
signString签名

2.3 签名方式

将接口参数按照ordersn=对应的值的方式连接后,进行md5加密即可

示例:待签名字符串 ordersn=20260814103935154282

md5加密后字符串 8ef6386e2495514f3f69f27b5b0472be

2.4 接口请求方式

POST

Content-Type:application/x-www-form-urlencoded

2.5 请求响应

参数名称类型说明示例
errnoInt错误号0 成功 -1失败
messageString描述文字
data
ordersnString领取记录ID20260814103935154282
agentidInt权益ID1
mobileString手机号18299999999
addtimeString领取时间2026-08-14 10:39:35
starttimeString权益开始日期2026-09-04 23:59:59
endtimeString权益结束日期2026-10-05 23:59:59
redpacketsArray发放红包
idInt红包ID1
discountFloat红包金额5
conditionFloat红包使用条件(满多少元)20
addtimeString红包发放时间2026-08-14 10:39:35
starttimeString红包有效期开始时间2026-09-04 23:59:59
endtimeString红包有效期结束时间2026-10-05 23:59:59
usetimeString红包使用时间
statusString红包状态1未使用 2已使用 3已过期
status_cnString红包状态说明未使用
正确响应示例
{
	"errno": 0,
	"message": "",
	"data": {
		"ordersn": "20260814103935154282",
  "agentid": 1,
		"mobile": "18299999999",
		"addtime": "2026-08-14 10:39:35",
		"starttime": "2026-09-04 23:59:59",
		"endtime": "2026-10-05 23:59:59",
		"redpackets": [{
			"id": "303",
			"discount": "5.00",
			"condition": "0.00",
			"addtime": "2026-08-14 10:39:35",
			"starttime": "2026-08-14 10:39:35",
			"endtime": "2026-09-14 10:39:35",
			"usetime": "",
			"status": "1",
			"status_cn": "未使用"
		}, {
			"id": "304",
			"discount": "6.00",
			"condition": "0.00",
			"addtime": "2026-08-14 10:39:35",
			"starttime": "2026-08-14 10:39:35",
			"endtime": "2026-09-14 10:39:35",
			"usetime": "",
			"status": "1",
			"status_cn": "未使用"
		}, {
			"id": "305",
			"discount": "7.00",
			"condition": "0.00",
			"addtime": "2026-08-14 10:39:35",
			"starttime": "2026-08-14 10:39:35",
			"endtime": "2026-09-14 10:39:35",
			"usetime": "",
			"status": "1",
			"status_cn": "未使用"
		}, {
			"id": "306",
			"discount": "8.00",
			"condition": "20.00",
			"addtime": "2026-08-14 10:39:35",
			"starttime": "2026-08-14 10:39:35",
			"endtime": "2026-09-14 10:39:35",
			"usetime": "",
			"status": "1",
			"status_cn": "未使用"
		}]
	}
}
错误响应示例
{
	errno: -1,
message: '领取记录ID不能为空' 
}

© 版权声明
THE END
文章不错?点个赞呗
点赞2359 分享
评论 抢沙发

请登录后发表评论

    请登录后查看评论内容