查询门店列表

分页查询应用已授权商户下的门店列表，支持按商户ID过滤。

请求

GET /open-api/v1/stores

请求参数

参数	类型	必填	说明
pageNo	int	否	页码，默认 1
pageSize	int	否	每页条数，默认 10，最大 100
merchantId	long	否	按商户ID过滤，不传则返回所有授权商户的门店
name	string	否	门店名称（模糊匹配）

请求示例

curl -X GET 'https://openapi.example.com/open-api/v1/stores?pageNo=1&pageSize=10&merchantId=1001' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

响应

响应参数

字段	类型	说明
list	array	门店列表
list[].id	long	门店 ID
list[].merchantId	long	所属商户 ID
list[].name	string	门店名称
list[].address	string	门店地址
list[].phone	string	门店电话
list[].latitude	double	纬度
list[].longitude	double	经度
list[].status	int	状态：0-正常 1-禁用
total	long	总记录数
pageNo	int	当前页码
pageSize	int	每页条数

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 2001,
        "merchantId": 1001,
        "name": "示例美容店(朝阳旗舰店)",
        "address": "北京市朝阳区xxx路xx号",
        "phone": "010-12345678",
        "latitude": 39.9042,
        "longitude": 116.4074,
        "status": 0
      }
    ],
    "total": 1,
    "pageNo": 1,
    "pageSize": 10
  }
}

相关接口

接口	路径	说明
查询门店详情	GET /open-api/v1/stores/{storeId}	获取单个门店完整信息
查询附近门店	GET /open-api/v1/stores/nearby	按经纬度查询附近门店
查询门店营业时间	GET /open-api/v1/stores/{storeId}/business-hours	获取门店详细营业时间段