加载中…
门店 store

模块说明

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。
添加日期:2026-10-06