简要描述:
- 订单弹幕
请求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,
}
]
}
}