资源接口列表 (查询商户信息)
需要授权
使用oauth2协议的accessToken和customerOpenId获取商家信息
请求参数:
签名:
GET请求地址:
环境 |
https请求地址 |
正式环境 |
https://openrealm.duolabao.com/v1/customerinfo |
公共请求参数:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
customerOpenId |
String |
是 |
32 |
商家open_id |
11084830284398 |
请求头:
请求头 |
示例值 |
描述 |
timestamp |
102202020202 |
时间戳 |
token |
44B74C2B0BDA30F8C949FC9F20FA5CB123E179E7 |
根据密钥和算法生成的结果 |
accessToken |
3rdsfaij43209dfaojf |
从授权系统获得的accessToken值 |
accessKey |
fe02aa7e8f3249fe86c93774b7103d9945f80 |
用户的公钥 |
请求示例:
-
1
|
https://openrealm.duolabao.com/v1/customerinfo/{customerOpenId}
|
-
1
|
https://openrealm.duolabao.com/v1/customerinfo/11084830284398
|
返回参数JSON格式:
参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
customerNum |
String |
是 |
32 |
商家id |
11084830284 |
customerName |
String |
是 |
32 |
商家名称 |
鸿毛饺子 |
address |
String |
是 |
32 |
商家地址 |
万通中心A |
email |
String |
是 |
32 |
商家邮箱 |
hmjz@163.com |
mobilePhone |
String |
是 |
32 |
商家电话 |
13800000000 |
result |
String |
是 |
32 |
SUCCESS表示成功,FAIL表示失败 |
success |
errorCode |
String |
是 |
32 |
错误码 |
customerNotExist |
errorMsg |
String |
是 |
32 |
错误信息 |
商户信息不存在 |
city |
String |
是 |
32 |
城市编码 |
北京 |
province |
String |
是 |
32 |
省份编码 |
北京 |
district |
String |
是 |
32 |
区域编码 |
朝阳区 |
address |
String |
是 |
32 |
商家地址 |
万通中心A |
industry |
String |
是 |
32 |
行业编码 |
美食 |
contactsName |
String |
是 |
32 |
商户联系人 |
李荣 |
gmtCreate |
String |
是 |
32 |
创建时间 |
1508835508000 |
响应示例:
-
1 |
{ |
2 |
"customerNum": "11084830284", |
3 |
"customerName": "鸿毛饺子", |
4 |
"address": "万通中心A", |
5 |
"email": “hmjz@163.com”, |
6 |
"mobilePhone": "13800000000", |
7 |
"result":"success" |
8 |
"city":"北京" |
9 |
"province":"北京" |
10 |
"district":"朝阳区" |
11 |
"address":"万通中心A" |
12 |
"industry":"美食" |
13 |
"contactsName":"李荣" |
17 |
"gmtCreate":"1508835508000" |
18 |
} |
错误响应示例:
-
1 |
{ |
2 |
"error": { |
3 |
"errorCode": |
4 |
"customerNotExist", |
5 |
"errorMsg":"商户信息不存在" |
6 |
}, |
7 |
"result": "fail" |
7 |
} |
错误码解释:
错误码 |
错误描述 |
解决方案 |
customerNotExis |
商戶信息不存在 |
商戶信息不存在 |