资源接口列表 (查询商户店面信息)
需要授权
使用oauth2协议的accessToken和customerOpenId获取商家所有的店铺信息
请求参数:
签名:
GET请求地址:
| 环境 |
https请求地址 |
| 正式环境 |
https://openrealm.duolabao.com/v1/shopinfo/list |
公共请求参数:
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| customerOpenId |
String |
是 |
32 |
商家open_id |
11029839829 |
请求头:
| 请求头 |
示例值 |
描述 |
| timestamp |
102202020202 |
时间戳 |
| token |
44B74C2B0BDA30F8C949FC9F20FA5CB123E179E7 |
根据密钥和算法生成的结果 |
| accessToken |
3rdsfaij43209dfaojf |
从授权系统获得的accessToken值 |
| accessKey |
fe02aa7e8f3249fe86c93774b7103d9945f80 |
用户的公钥 |
请求示例:
-
|
1
|
https://openrealm.duolabao.com/v1/shopinfo/list/{customerOpenId}
|
-
|
1
|
https://openrealm.duolabao.com/v1/shopinfo/list/11029839829
|
返回参数JSON格式:
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| result |
String |
是 |
32 |
SUCCESS表示成功,FAIL表示失败 |
success |
| shopList |
shopNum |
String |
是 |
32 |
店面id |
1212312312 |
| customerNum |
String |
是 |
32 |
所属商家id |
1324123 |
| shopName |
String |
是 |
32 |
店面名称 |
鸿毛饺子万通中心店 |
| address |
String |
是 |
32 |
店面地址 |
万通中心A座 |
| mapLng |
String |
是 |
32 |
经度 |
115.25 |
| mapLat |
String |
是 |
32 |
纬度 |
41.03 |
| mobilePhone |
String |
是 |
32 |
店面联系电话 |
13800000000 |
响应示例:
-
| 1 |
{ |
| 2 |
"result":"success", |
| 3 |
"shopList":[ |
| 4 |
{ |
| 5 |
"shopName": "1212312312", |
| 6 |
"customerNum": "1324123", |
| 7 |
"shopName": "鸿毛饺子万通中心店", |
| 8 |
"address": “万通中心A座”, |
| 9 |
"mapLng": "115.25’", |
| 10 |
"mapLat":"41.03", |
| 11 |
"mobilePhone":"13800000000" |
| 12 |
} |
| 13 |
] |
| 14 |
{ |
错误响应示例:
-
| 1 |
{ |
| 2 |
"error": { |
| 3 |
"errorCode": |
| 4 |
"customerNotExist", |
| 5 |
"errorMsg":"商户信息不存在" |
| 6 |
}, |
| 7 |
"result": "fail" |
| 7 |
} |
-
| 1 |
{ |
| 2 |
"error": { |
| 3 |
"errorCode": |
| 4 |
"errorMsg":"错误描述" |
| 5 |
}, |
| 6 |
"result": "error" |
| 7 |
} |
错误码解释:
| 错误码 |
错误描述 |
解决方案 |
| shopNotExist |
店铺信息不存在 |
店铺信息不存在 |
| customerNotExist |
店铺信息不存在 |
店铺信息不存在 |