新增门店

更新时间:2023-06-21 07:12:53下载pdf

本文介绍新增门店的 API。

接口描述

用于新增一个门店信息。

接口地址

POST: /v1.0/iot-03/retail/shops

请求参数

body 说明

参数名 类型 参数位置 是否必填 说明
parent_shop_id String false 父门店 ID,如果没有父门店,不传值
shop_name String true 门店名称
province_code Integer false 省份 code
province_name String false 省份名称
city_code Integer false 城市 code
city_name String false 城市名称
district_code Integer false 县区 code
district_name String false 县区名称
address String false 详细地址
business_hours List false 营业时间
shop_layout_plan String false 门店设备平面图

business_hours 说明

参数名 类型 参数位置 是否必填 说明
opening_time Long false 营业开始时间,建议 10 位或 13 位时间戳
closing_time Long false 营业结束时间,建议 10 位或 13 位时间戳

返回参数

参数名 类型 说明
result String 门店 ID

请求示例

POST: /v1.0/iot-03/retail/shops
{ "shop_name": "门店xxx", "province_code": 123, "province_name": "xxx省", "city_code": 456, "city_name": "xxx市", "district_code": 789, "district_name": "xxx区", "address": "xxx中心" }

返回示例

{ "result": "140509293102660xxx", "t": 1623835234825, "success": true }

错误码

参考 错误码

province_code, city_code, district_code 说明

中国城市建议参考 中华人民共和国行政区划代码