简要描述:
详情页接口新增参数说明
接口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": []
}