简要描述:

  • 订单弹幕

请求URL:

POST/wapapi/addons/orderbarrage/orderbarrage/getOrderBarrage

参数:

参数名 是否必须 类型 说明
use_place int 展示位置 1商城首页
rule_id int 规则id
type int 订单弹幕类型 1真实数据 2 虚拟数据 3真实+虚拟
virtual_num int 投放量

备注

#注意:第一次加载返回的数据是该商城的订单弹幕配置,根据返回配置信息进去相应请求# type: 1 真实数据 2 虚拟数据 3 真实+虚拟 type 为接口返回参数,用于二次请求
virtual_num:为前端所需返回的订单投放量,不传默认返回所有虚拟数据数量

# 第一次请求返回商城配置参数如下
{
    "code": 1,
    "message": "成功获取",
    "data": {
        "state": 1,//后台应用0关闭 1开启
		"type": 1,//订单弹幕类型 1真实数据 2 虚拟数据 3真实+虚拟
		"use_place": 1,//展示位置
		"rule": [
			{
			"rule_id":1,//规则id
			"start_time": 1574907467,//该时间段开始时间(前端转为时间段)
			"end_time": 1574933467,//该时间段结束时间(前端转为时间段)
			"virtual_num": 33,
			},
			{
			"rule_id":2,//规则id
			"start_time": 1574967467,
			"end_time": 1574997467,
			"virtual_num": 55,
			}
		]
    }
}

前端:

1、根据规则中返回的规则组时间段,控制不同时段去请求接口;virtual_num为每个规则组中的投放量。该时间段内请求接口的virtual_num一致
2、规则组中的space_end_time 为 投放间隔区间(相当隔 n秒 重新请求一次接口)
3、返回的时间戳前端只用转换为时间段 请求即可(例如:1574937467 实际为2019/11/28 18:37:47但是只用做判断时间段为18:37:47
4、接口每次只返回一条数据用于展示

返回示例:

错误时返回:

{
    "code": -1,
    "message": "订单弹幕已经关闭",

}
{
    "code": -2,
    "message": "订单弹幕已经结束", 

}

正确时返回:

返回参数说明:

参数名 类型 说明
user_name string 用户名
header string 头像
goods_name string 商品名
state int 应用0关闭 1开启
is_circle int 循环0不循环 1循环
rule array 规则组
start_time int 该时间段开始时间(前端转为时间段)
end_time int 该时间段结束时间(前端转为时间段)
virtual_num int 投放量
# 二次请求返回商城配置参数如下
{
    "code": 1,
    "message": "成功获取",
    "data": {
        "user_name": "微商来",
        "header": "http://wx.qlogo.cn/mmopen/l8g3msmAXXEMicwYqQxFbryD0dIicn1Vqxg4N7W8lq6yXI0OLyIx8cSiabF262lq1ialWiasnWcNVno83oALFo6zicsuwsmCTJlI3E/0",
		"goods_name": "微商来",
		"state": 1,
		"is_circle": 1,
		"rule": [
			{
			"rule_id":1,//规则id
			"start_time": 1574907467,//该时间段开始时间(前端转为时间段)
			"end_time": 1574933467,//该时间段结束时间(前端转为时间段)
			"virtual_num": 33,
			},
			{
			"rule_id":2,//规则id
			"start_time": 1574967467,
			"end_time": 1574997467,
			"virtual_num": 55,
			}
		]
    }
}