新增店铺
接口说明:每次最多批量新增10个店铺。
请求url
- /openapi/merchants/v5/addStores
接口协议以及签名计算
测试联调
入参说明
参数 |
示例 |
说明 |
clientId |
sssHhHPkzCNWG1sFs |
App-key |
shopId |
20000000000001715 |
商户ID |
timestamp |
1634095503814 |
毫秒级时间戳 |
data |
参考入参示例 |
业务入参 |
sign |
3F9CA839E3AAAA156CFBEE1A35A3DF89 |
签名 |
参数 |
字段描述 |
类型/是否必传 |
说明 |
thirdStoreId |
第三方店铺ID |
String(50)/NO |
长度最长为50 |
storeName |
店铺名称 |
String(80)/YES |
|
cityName |
城市名称 |
String(20)/YES |
查询开通城市接口获取 |
address |
店铺地址 |
String(80)/YES |
|
addressDetail |
店铺详细地址 |
String(80)/YES |
|
latitude |
店铺纬度(百度坐标系) |
String(20)/YES |
|
longitude |
店铺经度(百度坐标系) |
String(20)/YES |
|
phone |
店铺联系人手机号/座机 |
String(30)/YES |
支持手机号,支持座机号:格式 区号-座机号-分机号 如:010-1234567-123,分机号可省略 |
goodType |
店铺业务类型 |
Integer(8)/YES |
详见下放店铺类型枚举 |
参数 |
字段描述 |
类型/是否比传 |
说明 |
failList |
|
新增店铺失败列表 |
Object[]/YES |
|
|
dto |
新增店铺入参对象 |
Object/NO |
对应入参对象,请参考出参示例 |
|
reason |
新增店铺失败原因 |
String(100)/NO |
|
successList |
|
新增店铺成功列表 |
Object[]/YES |
|
|
dto |
新增店铺入参对象 |
Object/NO |
对应入参对象,请参考出参示例 |
|
storeId |
新增店铺ID |
Long(20)/NO |
|
店铺类型标签 |
店铺类型标签名称 |
1 |
文件 |
3 |
数码 |
5 |
蛋糕 |
6 |
餐饮 |
7 |
鲜花 |
9 |
汽配 |
10 |
其他 |
12 |
母婴 |
13 |
医药健康 |
15 |
商超 |
16 |
水果 |
clientId:sssHhHPkzCNWG1sFs
shopId:20000000000001715
timestamp:1634095503814
data:[{"storeName":"","cityName":"北京市","address":"中关村东升科技园国际园","addressDetail":"201","latitude":"40.048136","longitude":"116.378683","phone":"17500000000","goodType":5},{"storeName":"新增闪送CBD店铺","cityName":"北京市","address":"中关村东升科技园国际园","addressDetail":"201","latitude":"40.048136","longitude":"116.378683","phone":"17500000000","goodType":5}]
sign:7D0C4B076A808624CF908A42C1EC211E
{
"status": 200,
"msg": null,
"data": {
"failList": [
{
"dto": {
"thirdStoreId": null,
"storeName": "",
"cityName": "北京市",
"address": "中关村东升科技园国际园",
"addressDetail": "201",
"latitude": "40.048136",
"longitude": "116.378683",
"phone": "17500000000",
"goodType": 5
},
"reason": "店铺名称不能为空"
}
],
"successList": [
{
"dto": {
"thirdStoreId": null,
"storeName": "新增闪送CBD店铺",
"cityName": "北京市",
"address": "中关村东升科技园国际园",
"addressDetail": "201",
"latitude": "40.048136",
"longitude": "116.378683",
"phone": "17500000000",
"goodType": 5
},
"storeId": 2430117
}
]
}
}