模块说明
store 提供门店/网点的列表与详情接口:列表支持 class 筛选(如按区域)与分页,返回筛选选项 class_list;详情返回门店档案(地址、电话、坐标等,以站点字段为准)。
鉴权级别:可选。
接口一览
| 方法 | URL | 鉴权 | 说明 |
|---|---|---|---|
| GET | /api/store |
可选 | 门店列表 |
| GET | /api/store/show/{id} |
可选 | 门店详情 |
列表
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
class |
否 | 分类筛选值 |
page |
否 | 页码,默认 1 |
pageSize |
否 | 每页数量(0=用后台默认) |
响应
{
"code": "OK",
"message": "",
"data": {
"title": "门店",
"class": "",
"store_list": [ { "id": 1, "name": "...", "address": "...", "tel": "...", "...": "" } ],
"class_list": [ { "name": "全部", "value": "" } ],
"pager": { "page": 1, "page_size": 10, "record_count": 11, "page_count": 2 }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
详情
GET /api/store/show/2
{
"code": "OK",
"message": "",
"data": {
"title": "门店名",
"store": { "id": 2, "name": "...", "address": "...", "...": "" }
},
"errors": {},
"request_id": "9f2a5c8e1b3d7f40"
}
注意事项
- 列表键为
store_list、详情键为store; - 详情可能附带
defined(自定义字段,如营业时间、坐标); - 详情 ID 无效返回
422,记录不存在返回404。