添加门店基本信息。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
POST /CreateShop HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
Country | String | FormData | 否 | CN | 国家字段,CN:中国,SG:新加坡 |
ShopList | Array of Item | FormData | 否 | 门店列表,限制1~20门店 |
|
ShopId | String | FormData | 是 | ShopId | 自定义门店编号(ID)-必填 |
ShopName | String | FormData | 是 | 店铺名 | 门店名称-必填 |
Location | String | FormData | 否 | 杭州市滨江区江南大道1001号 | 门店地址-选填 |
Longitude | String | FormData | 否 | 120.20101 | 地理经度-必填 |
Latitude | String | FormData | 否 | 30.200714 | 地理纬度-必填 |
RegionAddress | String | FormData | 否 | 330108 | 区域地址-省市区(查询结果) |
RegionCode | String | FormData | 否 | 2500 | 区域编码(查询结果) |
Remark | String | FormData | 否 | 备注信息 | 备注(可空)-选填 |
ShopGroupIds | Array of String | FormData | 否 | ShopGroupId | 门店组ID |
WeekdaysStartTime | String | FormData | 否 | 08:00:00 | 工作日开始营业时间-选填,格式:HH:mm:ss |
WeekdaysEndTime | String | FormData | 否 | 17:00:00 | 工作日结束营业时间-选填,格式:HH:mm:ss |
WeekendStartTime | String | FormData | 否 | 08:00:00 | 周末开始营业时间-选填,格式:HH:mm:ss |
WeekendEndTime | String | FormData | 否 | 18:00:00 | 周末结束营业时间-选填,格式:HH:mm:ss |
BusinessStatus | Integer | FormData | 否 | 1 | 门店营业状态: 1-营业,2-待营业 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Success | Boolean | true | 成功标志 |
Message | String | success | 说明 |
Code | String | success | 状态码 |
HttpStatusCode | Integer | 200 | http状态码 |
RequestId | String | RequestId | 请求ID |
Data | Array of String | ShopId | 门店ID |
示例
请求示例
POST /CreateShop HTTP/1.1
Host:cd.aliyuncs.com
Content-Type:application/json
Country=CN&ShopList=[{"ShopId":"ShopId","ShopName":"店铺名","Location":"杭州市滨江区江南大道1001号","Longitude":"120.20101","Latitude":"30.200714","RegionAddress":"330108","RegionCode":"2500","Remark":"备注信息","ShopGroupIds":["ShopGroupId"],"WeekdaysStartTime":"08:00:00","WeekdaysEndTime":"17:00:00","WeekendStartTime":"08:00:00","WeekendEndTime":"18:00:00","BusinessStatus":1}]
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateShopResponse>
<Success>true</Success>
<Message>success</Message>
<Code>success</Code>
<HttpStatusCode>200</HttpStatusCode>
<RequestId>RequestId</RequestId>
<Data>ShopId</Data>
</CreateShopResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Success" : true,
"Message" : "success",
"Code" : "success",
"HttpStatusCode" : 200,
"RequestId" : "RequestId",
"Data" : "ShopId"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | Params.Illegal | The request parameters are invalid. | 请求入参非法 |
400 | Shop.Exist | The specified shop already exists. | 门店已存在 |
400 | Shop.Group.NotExist | The specified shop group does not exist. | 指定门店组不存在 |
401 | Unauthorized | You are not authorized to perform this operation. | 未授权的请求 |
403 | Forbidden | This request is prohibited. | 请求被禁止 |
503 | Service.Unavailable | The service is unavailable. Please try again later. | 服务当前暂不可用,请稍后重试 |
访问错误中心查看更多错误码。