查询商户详情

获取指定商户的详细信息。

请求

GET /open-api/v1/merchants/{merchantId}

路径参数

参数	类型	必填	说明
merchantId	long	是	商户 ID

请求示例

curl -X GET 'https://openapi.example.com/open-api/v1/merchants/1001' \
  -H 'X-App-Key: ak_1234567890abcdef' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

响应

响应参数

字段	类型	说明
id	long	商户 ID
merchantName	string	商户名称
merchantType	int	商户类型
contactName	string	联系人
contactPhone	string	联系电话
province	string	省份
city	string	城市
district	string	区县
address	string	详细地址
businessHours	string	营业时间
logoUrl	string	商户 Logo
description	string	商户简介
storeCount	int	门店数量

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1001,
    "merchantName": "示例美容店",
    "merchantType": 1,
    "contactName": "张三",
    "contactPhone": "138****1234",
    "province": "北京市",
    "city": "北京市",
    "district": "朝阳区",
    "address": "xxx路xx号",
    "businessHours": "09:00-21:00",
    "logoUrl": "https://cdn.example.com/logo/1001.png",
    "description": "专业美容护肤连锁品牌",
    "storeCount": 3
  }
}

错误码

错误码	说明
100008	无该商户数据权限（未授权）
200001	商户不存在
200002	商户已下线