简要描述:
详情页接口新增参数说明
接口route=plugin.shop-assistant.frontend.index.index新增参数store_income_show
响应参数说明
参数名 | 类型 | 说明 |
---|---|---|
store_income_show | int | 是否开启门店销售额排名 1开启,0关闭 |
店铺排行数据请求URL:
接口route=plugin.shop-assistant.frontend.index.get-store-rank
请求参数说明:
参数名 | 类型 | 是否必需 | 说明 |
---|---|---|---|
rank_type | int | 是 | 1门店,2 收银台 |
time_type_name | string | 否 | 1门店,2 收银台 |
time | int | 否 | 返回开始的零点时间时间戳,如果选择日则返回当天零点时间,周就返回周一的零点时间,月就返回1号的零点时间 |
返回示例:
正确时返回:
{
"result": 1,
"msg": "ok",
"data": {
"current_page": "1",
"data": [
{
"id": 12,
"name": "as小店",
"turnover": "600.00",
"complete_turnover": "600.00",
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 1,
"name": "dfsaf",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 2,
"name": "门店二",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 3,
"name": "d12313123123",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 4,
"name": "12222222222111",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 5,
"name": "asdasd123",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 6,
"name": "门店6",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 10,
"name": "门店7777",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
},
{
"id": 11,
"name": "123123",
"turnover": 0,
"complete_turnover": 0,
"withdraw": "0.00",
"un_withdraw": "0.00",
"withdrawing": "0.00"
}
],
"from": 1,
"last_page": 1,
"per_page": 15,
"total": 9
}
}
响应参数说明
参数名 | 类型 | 说明 |
---|---|---|
result | int | 接口状态码,1 表示成功 |
msg | string | 接口消息,成功时返回 "ok" |
data | object | 核心业务数据 |
data.current_page | string | 当前页码 |
data.data | array | 门店数据列表 |
data.from | int | 数据起始位置(分页偏移量) |
data.last_page | int | 总页数 |
data.per_page | int | 每页显示数量 |
data.total | int | 总数据量 |
门店对象字段说明(data.data[])
参数名 | 类型 | 说明 |
---|---|---|
id | int | 门店唯一标识 |
name | string | 门店名称 |
turnover | string | 累计营业额) |
complete_turnover | string | 累计交易完成营业额 |
withdraw | string | 累计已提现收入 |
un_withdraw | string | 累计未提现收入 |
withdrawing | float | 累计提现中收入 |
类型说明
- 金额字段:建议统一使用字符串类型保留两位小数(如 "0.00"),避免浮点数精度问题
- 分页参数:建议将 current_page 字段类型改为 int 保持类型一致性
错误时返回:
{
"result": 0,
"msg": "请登录",
"data": []
}