quintin.zhang / yohobuy-doc · Commits

Go to a project

Authored by chenchao
Commit b604dcf6abb4f48c41a886ebf5d8ac824c25ac2f 2 parents 0bfd79c5 c68c5cd6

Merge branch 'develop' of http://git.dev.yoho.cn/platform/yohobuy-doc into develop

Inline Side-by-side
Showing 7 changed files with 1237 additions and 833 deletions
@@ -10,8 +10,8 @@ @@ -10,8 +10,8 @@
10 |参数名 |必填 |类型 |示例值 |描述 | 10 |参数名 |必填 |类型 |示例值 |描述 |
11 |------ |---- |---- |------ |---- | 11 |------ |---- |---- |------ |---- |
12 |name |否 |string |男首页 |资源名称 | 12 |name |否 |string |男首页 |资源名称 |
13 -|sort_id |否 |int |2 |分类编号 |  
14 -|platform_id|否 |int |1 |平台编号 | 13 +|sortId |否 |int |2 |分类编号 |
  14 +|platformId |否 |int |1 |平台编号 |
15 |page |否 |int |1 |页数 | 15 |page |否 |int |1 |页数 |
16 16
17 #### 返回 17 #### 返回
@@ -28,28 +28,28 @@ @@ -28,28 +28,28 @@
28 { 28 {
29 "id":8, 29 "id":8,
30 "name":"男首页", 30 "name":"男首页",
31 - "sort_id":2,  
32 - "sort_name":"男首",  
33 - "platform_id":1,  
34 - "platform_name":"yohoApp", 31 + "sortId":2,
  32 + "sortName":"男首",
  33 + "platformId":1,
  34 + "platformName":"yohoApp",
35 "code":"201504091403001", 35 "code":"201504091403001",
36 - "match_code":"",  
37 - "create_time":1430378310,  
38 - "sort_list":[ 36 + "matchCode":"",
  37 + "createTime":1430378310,
  38 + "sorts":[
39 { 39 {
40 - "sort_id":2,  
41 - "sort_name":"男首",  
42 - "platform_id":"1",  
43 - "create_time":1430304722, 40 + "sortId":2,
  41 + "sortName":"男首",
  42 + "platformId":"1",
  43 + "createTime":1430304722,
44 "status":1 44 "status":1
45 } 45 }
46 ], 46 ],
47 - "plat_list":[ 47 + "platforms":[
48 { 48 {
49 - "platform_id":1,  
50 - "platform_name":"yohoApp",  
51 - "platform_flag":"iphone",  
52 - "create_time":1430300615, 49 + "platformId":1,
  50 + "platformName":"yohoApp",
  51 + "platformFlag":"iphone",
  52 + "createTime":1430300615,
53 "status":1 53 "status":1
54 } 54 }
55 ] 55 ]
@@ -69,12 +69,12 @@ @@ -69,12 +69,12 @@
69 |content |内容 | 69 |content |内容 |
70 |id |资源编号 | 70 |id |资源编号 |
71 |name |资源名称 | 71 |name |资源名称 |
72 -|sort_id |分类编号 |  
73 -|sort_name |分类名称 |  
74 -|platform_id|平台编号 |  
75 -|platform_name|平台名称 | 72 +|sortId |分类编号 |
  73 +|sortName |分类名称 |
  74 +|platformId |平台编号 |
  75 +|platformName|平台名称 |
76 |code |资源码 | 76 |code |资源码 |
77 -|match_code |配对码 |  
78 -|create_time|创建时间 |  
79 -|sort_list |分类列表 |  
80 -|plat_list |平台列表 |  
  77 +|matchCode |配对码 |
  78 +|createTime |创建时间 |
  79 +|sorts |分类列表 |
  80 +|platforms |平台列表 |
1 -# 产品颜色管理接口服务定义  
2 ----------------------  
3 -  
4 -# 添加颜色接口  
5 -  
6 -> 接口名： `/productColor/addProductColor/`  
7 -  
8 -### 入参  
9 -  
10 --------------------------  
11 -|属性名称|类型|例子|说明|是否必填|  
12 -|--------|----|----|----|--------|  
13 -|colorName|string|nike|颜色名称|是|  
14 -|colorCode|string|n|RGB code|是|  
15 -|colorValue|string|图片URL|一级分类|是|  
16 -  
17 ----------------------  
18 -  
19 -### 返回  
20 -  
21 -``` json  
22 -{  
23 - "code":200,  
24 - "message":"success"  
25 -}  
26 -  
27 -```  
28 -  
29 -# 获取颜色列表  
30 -  
31 -> 接口名： `/productColor/queryProductColors`  
32 -  
33 -### 入参  
34 -  
35 --------------------------  
36 -|属性名称|类型|例子|说明|是否必填|  
37 -|-------|----|----|----|-------|  
38 ---------------------------------  
39 -  
40 -### 返回  
41 -  
42 -``` json  
43 -{  
44 - code:200,  
45 - message:"",  
46 - data: {  
47 - list: [{  
48 - categoryName: '', //品类名称  
49 - categoryAbbr: '', //品类缩写  
50 - firstCategory: '', //一级分类  
51 - secondCategory: '', //二级分类  
52 - thirdCategory: '', //三级分类  
53 - categorySort: '', //排序  
54 - categoryStatus: '',//状态,  
55 - id: '', //品类ID  
56 - }]  
57 - page: '', //当前第几页  
58 - size: '', //每页多少条  
59 - }  
60 -}  
61 -  
62 -```  
63 -  
64 -  
65 -  
66 -  
67 -  
68 -  
69 -# 更新产品颜色接口  
70 -  
71 -> 接口名： `/product/updateProductAttribute`  
72 -  
73 -### 入参  
74 -  
75 --------------------------  
76 -|属性名称|类型|例子|说明|是否必填|  
77 -|--------|----|----|----|--------|  
78 -|id |int|1 |id |是 |  
79 -|colorName|string|nike|颜色名称|是|  
80 -|colorCode|string|n|RGB code|是|  
81 -|colorValue|string|图片URL|一级分类|是|  
82 ----------------------  
83 -  
84 -### 返回  
85 -  
86 -``` json  
87 -{  
88 - "code": 200,  
89 - "data": [],  
90 - "md5": "d751713988987e9331980363e24189ce",  
91 - "message": "Product Attribute update success."  
92 -}  
93 -  
94 -```  
95 -  
96 -  
97 -  
98 -# 获取单个产品颜色接口  
99 -  
100 -> 接口名： `/product/queryProductColor`  
101 -  
102 -### 入参  
103 -  
104 --------------------------  
105 -|属性名称|类型|例子|说明|是否必填|  
106 -|--------|----|----|----|--------|  
107 -|param|int|1|颜色ID|是  
108 ----------------------  
109 -  
110 -### 返回  
111 -  
112 -``` json  
113 -{  
114 - "code": 200,  
115 - "data": {  
116 - "colorCode": "cc",  
117 - "colorName": "hongse",  
118 - "colorValue": "cc-value",  
119 - "id": 16  
120 - },  
121 - "md5": "d08f272cd425a5a89528299e5ab9ebdf",  
122 - "message": "success"  
123 -}  
124 -  
125 -```  
126 - 1 +# 文件上传接口服务定义
  2 +---------------------
  3 +
  4 +# 添加颜色接口
  5 +
  6 +> 接口名： `/fileupload/upload/`
  7 +
  8 +
  9 +### 入参
  10 +
  11 +-------------------------
  12 +|属性名称|类型|例子|说明|是否必填|
  13 +|--------|----|----|----|--------|
  14 +|file|file|-|颜色名称|是|
  15 +|userId|int|543883|用户id|是|
  16 +|bucket|string|smart|bucket|是|
  17 +
  18 +---------------------
  19 +
  20 +### 返回
  21 +
  22 +``` json
  23 +{
  24 + "code":200,
  25 + "data" : "url", --图片URL
  26 + "message":"success"
  27 +}
  28 +
  29 +```
  30 +
@@ -10,9 +10,9 @@ @@ -10,9 +10,9 @@
10 ------------------------- 10 -------------------------
11 |属性名称|类型|例子|说明|是否必填| 11 |属性名称|类型|例子|说明|是否必填|
12 |--------|----|----|----|--------| 12 |--------|----|----|----|--------|
13 -|colorName|string|nike|颜色名称|是|  
14 -|colorCode|string|n|RGB code|是|  
15 -|colorValue|string|图片URL|一级分类|是| 13 +|colorName|string|X色|颜色名称|是|
  14 +|colorCode|string|FFFF|RGB code|是|
  15 +|colorValue|string|www.io.png|图片URL|是|
16 16
17 --------------------- 17 ---------------------
18 18
@@ -143,9 +143,9 @@ @@ -143,9 +143,9 @@
143 |属性名称|类型|例子|说明|是否必填| 143 |属性名称|类型|例子|说明|是否必填|
144 |--------|----|----|----|--------| 144 |--------|----|----|----|--------|
145 |id |int|1 |id |是 | 145 |id |int|1 |id |是 |
146 -|colorName|string|nike|颜色名称|是|  
147 -|colorCode|string|n|RGB code|是|  
148 -|colorValue|string|图片URL|一级分类|是| 146 +|colorName|string|X色|颜色名称|是|
  147 +|colorCode|string|000fff|RGB code|是|
  148 +|colorValue|string|www.meili.png|图片URL|是|
149 --------------------- 149 ---------------------
150 150
151 ### 返回 151 ### 返回
  1 +## 1.数据库（erp_supplier）
  2 +### 1.1 店铺管理员（erp_supplier.shops_admin）
  3 +#### sql 脚本
  4 +```sql
  5 +CREATE TABLE `shops_admin` (
  6 + `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  7 + `shops_id` int(11) unsigned NOT NULL,
  8 + `admin_pid` int(11) unsigned NOT NULL,
  9 + `identity` tinyint(3) unsigned DEFAULT '1' COMMENT '1、店长 2、供应商 3、店员',
  10 + `create_time` int(10) unsigned NOT NULL DEFAULT '0',
  11 + `update_time` int(10) unsigned NOT NULL DEFAULT '0',
  12 + `status` tinyint(4) NOT NULL DEFAULT '1' COMMENT '1、正常 2、已删除',
  13 + PRIMARY KEY (`id`)
  14 +) ENGINE=InnoDB AUTO_INCREMENT=836 DEFAULT CHARSET=utf8;
  15 +
  16 +```
  17 +#### 说明：增加标识字段status 1 表示正常记录 2 表示已删除记录
1 -# 店铺管理员接口服务定义  
2 ----------------------  
3 -  
4 -## 获取店铺管理员列表  
5 -  
6 -> 接口名：`/shops/getShopsAdminList`  
7 -  
8 -### 入参  
9 -  
10 --------------------------  
11 -|属性名称|类型|例子|说明|  
12 -|--------|----|----|----|  
13 -|page|int|2|第几页|  
14 -|size|int|50|每页条数|  
15 ----------------------  
16 -  
17 -### 返回  
18 -  
19 -``` json  
20 -{  
21 - "code":200,  
22 - "message":"list",  
23 - "data":{  
24 -  
25 - }  
26 -}  
27 -```  
28 -  
29 -  
30 -## 添加店铺管理员关系  
31 -> 接口名： `/shops/addAdminRelation`  
32 -  
33 -### 入参  
34 -  
35 --------------------------  
36 -|属性名称|类型|例子|说明|  
37 -|--------|----|----|----|  
38 -|shopsId|int|15|店铺ID|  
39 -|adminPid|int|2951|管理员ID|  
40 -|identity|int|1|身份(1、店长 2、供应商 3、店员)|  
41 ----------------------------  
42 -  
43 -### 返回  
44 -  
45 -```json  
46 -{  
47 - "code":500  
48 - "message":"shops_id is null"  
49 -}  
50 -{  
51 - "code":500  
52 - "message":"admin_pid is null"  
53 -}  
54 -{  
55 - "code":500  
56 - "message":"该关系已存在"  
57 -}  
58 -{  
59 - "code":500  
60 - "message":"添加失败"  
61 -}  
62 -{  
63 - "code":200  
64 - "message":"添加成功"  
65 -}  
66 -  
67 -```  
68 -  
69 -## 删除店铺管理员关系  
70 -> 接口名： `/shops/delAdminRelation`  
71 -  
72 -### 入参  
73 -  
74 --------------------------  
75 -|属性名称|类型|例子|说明|  
76 -|--------|----|----|----|  
77 -|id|int|20|店铺管理员记录ID|  
78 -|shopsId|int|15|店铺ID|  
79 ----------------------------  
80 -  
81 -### 返回  
82 -  
83 -```json  
84 -{  
85 - "code":500  
86 - "message":"id is null"  
87 -}  
88 -{  
89 - "code":200  
90 - "message":"删除成功!"  
91 -}  
92 -```  
93 -  
94 -## 获取管理员关系详情  
95 -  
96 -> 接口名：`/shops/getAdminRelationDetailById`  
97 -  
98 -### 入参  
99 -  
100 --------------------------  
101 -|属性名称|类型|例子|说明|  
102 -|--------|----|----|----|  
103 -|id|int|20|店铺管理员记录ID|  
104 -|shopsId|int|15|店铺ID|  
105 --------------------  
106 -  
107 -### 返回  
108 -  
109 -```json  
110 -{  
111 - "code":500,  
112 - "message":"id is null"  
113 -}  
114 -{  
115 - "code":500,  
116 - "message":"shops_id is null"  
117 -}  
118 -{  
119 - "code":500,  
120 - "message":"暂无数据"  
121 -}  
122 -{  
123 - "code":200,  
124 - "message":"list",  
125 - "data":{  
126 -  
127 - }  
128 -}  
129 -```  
130 -  
131 -  
132 -## 修改店铺管理员关系  
133 -  
134 -> 接口名: `/shops/updateAdminRalation`  
135 -  
136 -### 入参  
137 -  
138 --------------------------  
139 -|属性名称|类型|例子|说明|  
140 -|--------|----|----|----|  
141 -|shopDomain|String|debao|店铺域名|  
142 -|shopsId|int|15|店铺ID|  
143 ------------------------------  
144 -  
145 -### 返回  
146 -  
147 -```json  
148 -{  
149 - "code":500  
150 - "message":"id is null"  
151 -}  
152 -{  
153 - "code":500  
154 - "message":"shops_id is null"  
155 -}  
156 -{  
157 - "code":500  
158 - "message":"admin_pid is null"  
159 -}  
160 -{  
161 - "code":500  
162 - "message":"该关系已存在"  
163 -}  
164 -{  
165 - "code":200  
166 - "message":"修改成功"  
167 -}  
168 -  
169 -```  
170 - 1 +# 店铺管理员接口服务定义
  2 +---------------------
  3 +
  4 +## 获取店铺管理员列表
  5 +
  6 +> 接口名：`/ShopsAdminRest/getShopsAdminList`
  7 +
  8 +### 入参
  9 +``` json
  10 +{
  11 + "page":2,
  12 + "size":12
  13 +}
  14 +```
  15 +-------------------------
  16 +|属性名称|类型|例子|说明|
  17 +|--------|----|----|----|
  18 +|page|int|2|第几页|
  19 +|size|int|50|每页条数|
  20 +---------------------
  21 +
  22 +### 返回
  23 +
  24 +``` json
  25 +{
  26 + "code": 200,
  27 + "data": {
  28 + "list": [
  29 + {
  30 + "adminName": "",
  31 + "adminPid": 10180,
  32 + "createTime": "2016-01-14 11:03:44",
  33 + "id": 822,
  34 + "identity": 1,
  35 + "shopName": "MO&Co.",
  36 + "shopsId": 420,
  37 + "updateTime": "1970-01-01 08:00:00"
  38 + },
  39 + {
  40 + "adminName": "成凤驹",
  41 + "adminPid": 2738,
  42 + "createTime": "2016-01-11 16:49:32",
  43 + "id": 820,
  44 + "identity": 7,
  45 + "shopName": "Faroma",
  46 + "shopsId": 430,
  47 + "updateTime": "1970-01-01 08:00:00"
  48 + },
  49 + {
  50 + "adminName": "朱云青",
  51 + "adminPid": 2314,
  52 + "createTime": "2016-01-11 16:49:15",
  53 + "id": 819,
  54 + "identity": 7,
  55 + "shopName": "Faroma",
  56 + "shopsId": 430,
  57 + "updateTime": "1970-01-01 08:00:00"
  58 + },
  59 + {
  60 + "adminName": "",
  61 + "adminPid": 10040,
  62 + "createTime": "2016-01-11 16:48:37",
  63 + "id": 818,
  64 + "identity": 6,
  65 + "shopName": "朴坊Simplemill",
  66 + "shopsId": 319,
  67 + "updateTime": "1970-01-01 08:00:00"
  68 + },
  69 + {
  70 + "adminName": "",
  71 + "adminPid": 2944,
  72 + "createTime": "2016-01-11 16:47:27",
  73 + "id": 817,
  74 + "identity": 7,
  75 + "shopName": "WWTorres",
  76 + "shopsId": 429,
  77 + "updateTime": "1970-01-01 08:00:00"
  78 + },
  79 + {
  80 + "adminName": "朱云青",
  81 + "adminPid": 2314,
  82 + "createTime": "2016-01-11 16:47:15",
  83 + "id": 816,
  84 + "identity": 7,
  85 + "shopName": "WWTorres",
  86 + "shopsId": 429,
  87 + "updateTime": "1970-01-01 08:00:00"
  88 + },
  89 + {
  90 + "adminName": "",
  91 + "adminPid": 3161,
  92 + "createTime": "2016-01-08 15:21:11",
  93 + "id": 815,
  94 + "identity": 7,
  95 + "shopName": "MO&Co.edition",
  96 + "shopsId": 426,
  97 + "updateTime": "1970-01-01 08:00:00"
  98 + },
  99 + {
  100 + "adminName": "",
  101 + "adminPid": 3069,
  102 + "createTime": "2016-01-08 15:20:58",
  103 + "id": 814,
  104 + "identity": 7,
  105 + "shopName": "MO&Co.edition",
  106 + "shopsId": 426,
  107 + "updateTime": "1970-01-01 08:00:00"
  108 + },
  109 + {
  110 + "adminName": "",
  111 + "adminPid": 10172,
  112 + "createTime": "2016-01-08 14:00:53",
  113 + "id": 813,
  114 + "identity": 7,
  115 + "shopName": "ELECOM 宜丽客",
  116 + "shopsId": 421,
  117 + "updateTime": "1970-01-01 08:00:00"
  118 + },
  119 + {
  120 + "adminName": "朱云青",
  121 + "adminPid": 2314,
  122 + "createTime": "2016-01-08 14:00:37",
  123 + "id": 812,
  124 + "identity": 7,
  125 + "shopName": "ELECOM 宜丽客",
  126 + "shopsId": 421,
  127 + "updateTime": "1970-01-01 08:00:00"
  128 + },
  129 + {
  130 + "adminName": "",
  131 + "adminPid": 3161,
  132 + "createTime": "2016-01-08 13:23:48",
  133 + "id": 811,
  134 + "identity": 7,
  135 + "shopName": "MO&Co.",
  136 + "shopsId": 420,
  137 + "updateTime": "1970-01-01 08:00:00"
  138 + },
  139 + {
  140 + "adminName": "",
  141 + "adminPid": 3069,
  142 + "createTime": "2016-01-08 13:23:32",
  143 + "id": 810,
  144 + "identity": 7,
  145 + "shopName": "MO&Co.",
  146 + "shopsId": 420,
  147 + "updateTime": "1970-01-01 08:00:00"
  148 + }
  149 + ],
  150 + "page": 2,
  151 + "size": 12,
  152 + "total": 803,
  153 + "totalPage": 67
  154 + },
  155 + "message": "操作成功"
  156 +}
  157 +```
  158 +
  159 +
  160 +## 添加店铺管理员关系
  161 +> 接口名： `/ShopsAdminRest/addAdminRelation`
  162 +
  163 +### 入参
  164 +```json
  165 +{
  166 + "shopsId":15,
  167 + "adminPid":2,
  168 + "identity":12
  169 +}
  170 +```
  171 +-------------------------
  172 +|属性名称|类型|例子|说明|
  173 +|--------|----|----|----|
  174 +|shopsId|int|15|店铺ID|
  175 +|adminPid|int|2951|管理员ID|
  176 +|identity|int|1|身份(1、品牌公司 2、品牌经销商3、品牌代运营商4、有货品牌经理 5、有货店铺运营 6、有货商品运营7、有货平台运营) 可选 默认为1|
  177 +---------------------------
  178 +
  179 +### 返回
  180 +
  181 +```json
  182 +{
  183 + "code":500
  184 + "message":"shopsId is null"
  185 +}
  186 +{
  187 + "code":500
  188 + "message":"adminPid is null"
  189 +}
  190 +{
  191 + "code":500
  192 + "message":"该关系已存在"
  193 +}
  194 +{
  195 + "code":500
  196 + "message":"添加失败"
  197 +}
  198 +{
  199 + "code":200
  200 + "message":"添加成功"
  201 +}
  202 +
  203 +```
  204 +
  205 +## 删除店铺管理员关系
  206 +> 接口名： `/ShopsAdminRest/delAdminRelation`
  207 +
  208 +### 入参
  209 +```json
  210 +{
  211 + "id":24
  212 +}
  213 +```
  214 +-------------------------
  215 +|属性名称|类型|例子|说明|
  216 +|--------|----|----|----|
  217 +|id|int|20|店铺管理员记录ID|
  218 +---------------------------
  219 +
  220 +### 返回
  221 +
  222 +```json
  223 +{
  224 + "code":500
  225 + "message":"id is null"
  226 +}
  227 +{
  228 + "code":200
  229 + "message":"删除成功!"
  230 +}
  231 +```
  232 +
  233 +## 获取管理员关系详情
  234 +
  235 +> 接口名：`/ShopsAdminRest/getAdminRelationDetailById`
  236 +
  237 +### 入参
  238 +```json
  239 +{
  240 + "id":20
  241 +}
  242 +```
  243 +-------------------------
  244 +|属性名称|类型|例子|说明|
  245 +|--------|----|----|----|
  246 +|id|int|20|店铺管理员记录ID|
  247 +-------------------
  248 +
  249 +### 返回
  250 +
  251 +```json
  252 +{
  253 + "code":500,
  254 + "message":"id is null"
  255 +}
  256 +{
  257 + "code":500,
  258 + "message":"暂无数据"
  259 +}
  260 +{
  261 + "code": 200,
  262 + "data": {
  263 + "adminPid": 2951,
  264 + "createTime": 1441937052,
  265 + "id": 20,
  266 + "identity": 7,
  267 + "shopsId": 15,
  268 + "updateTime": 0
  269 + },
  270 + "message": "list"
  271 +}
  272 +```
  273 +
  274 +
  275 +## 修改店铺管理员关系
  276 +
  277 +> 接口名: `/ShopsAdminRest/updateAdminRalation`
  278 +
  279 +### 入参
  280 +```json
  281 +{
  282 + "id":20,
  283 + "shopsId":15,
  284 + "adminPid":2951,
  285 + "identity":2
  286 +}
  287 +```
  288 +-------------------------
  289 +|属性名称|类型|例子|说明|
  290 +|--------|----|----|----|
  291 +|id|int|20|店铺管理员记录ID|
  292 +|shopsId|int|15|店铺ID|
  293 +|adminPid|int|2951|管理员ID|
  294 +|identity|int|1|身份(1、品牌公司 2、品牌经销商3、品牌代运营商4、有货品牌经理 5、有货店铺运营 6、有货商品运营7、有货平台运营) 可选 默认为1|
  295 +-----------------------------
  296 +
  297 +### 返回
  298 +
  299 +```json
  300 +{
  301 + "code":500
  302 + "message":"id is null"
  303 +}
  304 +{
  305 + "code":500
  306 + "message":"shopsId is null"
  307 +}
  308 +{
  309 + "code":500
  310 + "message":"adminPid is null"
  311 +}
  312 +{
  313 + "code":500
  314 + "message":"该关系已存在"
  315 +}
  316 +{
  317 + "code":200
  318 + "message":"修改成功"
  319 +}
  320 +
  321 +```
  322 +
  323 +## 根据身份获取用户
  324 +
  325 +> 接口名: `/ShopsAdminRest/getUsersByIdentity`
  326 +
  327 +### 入参
  328 +```json
  329 +{
  330 + "identity":1
  331 +}
  332 +```
  333 +-------------------------
  334 +|属性名称|类型|例子|说明|
  335 +|--------|----|----|----|
  336 +|identity|int|1|身份(1、品牌公司 2、品牌经销商3、品牌代运营商4、有货品牌经理 5、有货店铺运营 6、有货商品运营7、有货平台运营)|
  337 +-----------------------------
  338 +
  339 +### 返回
  340 +
  341 +```json
  342 +{
  343 + "code":440
  344 + "message":"身份不存在！"
  345 +}
  346 +{
  347 + "code":200
  348 + "message":"0"
  349 +}
  350 +{
  351 + "code":200
  352 + "message":"null"
  353 +}
  354 +{
  355 + "code":500
  356 + "message":"该关系已存在"
  357 +}
  358 +{
  359 + "code": 200,
  360 + "data": [
  361 + {
  362 + "identity": 1,
  363 + "identityCn": "品牌公司",
  364 + "pid": 100001,
  365 + "supplierId": 0,
  366 + "truename": "tuk"
  367 + },
  368 + {
  369 + "identity": 1,
  370 + "identityCn": "品牌公司",
  371 + "pid": 100002,
  372 + "supplierId": 0,
  373 + "truename": "test9"
  374 + },
  375 + {
  376 + "identity": 1,
  377 + "identityCn": "品牌公司",
  378 + "pid": 100008,
  379 + "supplierId": 0,
  380 + "truename": "小松鼠"
  381 + },
  382 + {
  383 + "identity": 1,
  384 + "identityCn": "品牌公司",
  385 + "pid": 100010,
  386 + "supplierId": 0,
  387 + "truename": "Z"
  388 + },
  389 + {
  390 + "identity": 1,
  391 + "identityCn": "品牌公司",
  392 + "pid": 100016,
  393 + "supplierId": 0,
  394 + "truename": "AAA"
  395 + }
  396 + ],
  397 + "message": "all user"
  398 +}
  399 +
  400 +```
  401 +
  402 +## 获取所有身份
  403 +
  404 +> 接口名: `/EnumListRest/getEnumList`
  405 +
  406 +### 入参
  407 +无
  408 +-----------------------------
  409 +### 返回
  410 +```json
  411 +"IdentityEnum": [
  412 + {
  413 + "name": "品牌公司",
  414 + "value": 1
  415 + },
  416 + {
  417 + "name": "品牌经销商",
  418 + "value": 2
  419 + },
  420 + {
  421 + "name": "品牌代运营商",
  422 + "value": 3
  423 + },
  424 + {
  425 + "name": "有货品牌经理",
  426 + "value": 4
  427 + },
  428 + {
  429 + "name": "有货店铺运营",
  430 + "value": 5
  431 + },
  432 + {
  433 + "name": "有货商品运营",
  434 + "value": 6
  435 + },
  436 + {
  437 + "name": "有货平台运营",
  438 + "value": 7
  439 + }
  440 +```
  441 +其中：key为IdentityEnum
  442 +
  443 +```json
  444 +{
  445 + "code": 200,
  446 + "data": {
  447 + "CheckStatusEnum": [
  448 + {
  449 + "name": "暂存",
  450 + "value": 100
  451 + },
  452 + {
  453 + "name": "审核中",
  454 + "value": 200
  455 + },
  456 + {
  457 + "name": "通过",
  458 + "value": 300
  459 + },
  460 + {
  461 + "name": "驳回",
  462 + "value": 900
  463 + }
  464 + ],
  465 + "IdentityEnum": [
  466 + {
  467 + "name": "品牌公司",
  468 + "value": 1
  469 + },
  470 + {
  471 + "name": "品牌经销商",
  472 + "value": 2
  473 + },
  474 + {
  475 + "name": "品牌代运营商",
  476 + "value": 3
  477 + },
  478 + {
  479 + "name": "有货品牌经理",
  480 + "value": 4
  481 + },
  482 + {
  483 + "name": "有货店铺运营",
  484 + "value": 5
  485 + },
  486 + {
  487 + "name": "有货商品运营",
  488 + "value": 6
  489 + },
  490 + {
  491 + "name": "有货平台运营",
  492 + "value": 7
  493 + }
  494 + ],
  495 + "ShopNatureEnum": [
  496 + {
  497 + "name": "旗舰店",
  498 + "value": 1
  499 + },
  500 + {
  501 + "name": "专卖店",
  502 + "value": 2
  503 + }
  504 + ],
  505 + "ShopOperationStatusEnum": [
  506 + {
  507 + "name": "店铺未创建",
  508 + "value": 1
  509 + },
  510 + {
  511 + "name": "店铺已创建",
  512 + "value": 2
  513 + }
  514 + ],
  515 + "ShopsTypeEnum": [
  516 + {
  517 + "name": "单品店",
  518 + "value": 1
  519 + },
  520 + {
  521 + "name": "多品店",
  522 + "value": 2
  523 + }
  524 + ],
  525 + "StatusEnum": [
  526 + {
  527 + "name": "关闭",
  528 + "value": 0
  529 + },
  530 + {
  531 + "name": "开启",
  532 + "value": 1
  533 + },
  534 + {
  535 + "name": "已删除",
  536 + "value": 2
  537 + }
  538 + ]
  539 + },
  540 + "message": "操作成功"
  541 +}
  542 +
  543 +```
1 -# 店铺接口服务定义  
2 ----------------------  
3 -  
4 -## 创建店铺  
5 -  
6 -> 接口名：`/shops/createShop`  
7 -  
8 -### 入参  
9 -  
10 --------------------------  
11 -|属性名称|类型|例子|说明|  
12 -|--------|----|----|----|  
13 -|shopName|String|得宝旗舰店|店铺名称|  
14 -|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|  
15 -|shopDomain|String|debao|店铺域名|  
16 -|createPid|int|1|创建人ID|  
17 -|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|  
18 -|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|  
19 -|shopAdmin|JSON数组|||  
20 -|shopRelation|JSON数组|||  
21 -|websiteUrl|JSON数组|["www.paperworks.com.cn"]||  
22 -|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||  
23 -|shopAddress|JSON数组|||  
24 ----------------------  
25 -  
26 -### 返回  
27 -  
28 -``` json  
29 -{  
30 - "code":200,  
31 - "message":"创建成功",  
32 - "data":{  
33 - "shopId":12  
34 - }  
35 -}  
36 -{  
37 - "code":500,  
38 - "message":"创建失败",  
39 - "data":{  
40 - "shopId":-12  
41 - }  
42 -}  
43 -{  
44 - "code":500  
45 - "message":"shop_name is null"  
46 -}  
47 -{  
48 - "code":500  
49 - "message":"Sorry,店铺名已存在"  
50 -}  
51 -{  
52 - "code":500  
53 - "message":"shop_domain is null"  
54 -}  
55 -{  
56 - "code":500  
57 - "message":"Sorry,店铺域名已存在"  
58 -}  
59 -{  
60 - "code":500  
61 - "message":"shop_admin is null"  
62 -}  
63 -{  
64 - "code":500  
65 - "message":"shop_relation is null"  
66 -}  
67 -```  
68 -  
69 -  
70 -## 获取店铺列表  
71 -> 接口名： `/shops/getShopList`  
72 -  
73 -### 入参  
74 -  
75 --------------------------  
76 -|属性名称|类型|例子|说明|  
77 -|--------|----|----|----|  
78 -|page|int|2|第几页|  
79 -|size|int|50|每页条数|  
80 -|shopsId|int|15|店铺ID|  
81 -|shopName|String|得宝旗舰店|店铺名称|  
82 -|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|  
83 -|status|int|1|状态(1开启 0 关闭)|  
84 -|checkStatus|int|300|审核状态(100 暂存 200 待审核 300 审核通过 900 驳回)|  
85 -|supplierId|int|950|供应商ID|  
86 -|brandId|int|928|品牌ID|  
87 ----------------------------  
88 -  
89 -### 返回  
90 -  
91 -```json  
92 -  
93 -{  
94 - "code":200  
95 - "message":"ok"  
96 - "data":  
97 - {  
98 - "page":1,  
99 - "totalPage": 10,  
100 - "total": 100  
101 - "size": 10,  
102 - "list":  
103 - {  
104 - "shopsId": 15,  
105 - "shopName": "",  
106 - "shopDomain": "",  
107 - "shopNature": "",  
108 - "shopLogo": "",  
109 - "websiteUrl": "",  
110 - "shopAddress": "",  
111 - "createPid": "",  
112 - "checkStatus": "",  
113 - "createTime": "",  
114 - "updateTime": "",  
115 - "status": "",  
116 - "shopsAdmin": {  
117 - "id": "",  
118 - "shopsId": "",  
119 - "adminPid": "",  
120 - "identity": "",  
121 - "createTime": "",  
122 - "updateTime": ""  
123 - },  
124 - "shopsBrandList": [{  
125 - "id": "",  
126 - "shopsId": "",  
127 - "brandId": "",  
128 - "supplierId": "",  
129 - "createTime": "",  
130 - "updateTime": "",  
131 - "agreementEndTime": ""  
132 - },{  
133 - "id": "",  
134 - "shopsId": "",  
135 - "brandId": "",  
136 - "supplierId": "",  
137 - "createTime": "",  
138 - "updateTime": "",  
139 - "agreementEndTime": ""  
140 - }],  
141 - "shopsSupplierList": [{  
142 - "id": "",  
143 - "shopsId": "",  
144 - "brandId": "",  
145 - "brandName": "",  
146 - "agreementEndTime": ""  
147 - },{  
148 - "id": "",  
149 - "shopsId": "",  
150 - "brandId": "",  
151 - "brandName": "",  
152 - "agreementEndTime": ""  
153 - }]  
154 - }  
155 - }  
156 -}  
157 -```  
158 -  
159 -## 店铺同步  
160 -> 接口名： `/shops/synchronizeShop`  
161 -  
162 -### 入参  
163 -  
164 --------------------------  
165 -|属性名称|类型|例子|说明|  
166 -|--------|----|----|----|  
167 -|shopName|String|得宝旗舰店|店铺名称|  
168 -|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|  
169 -|shopDomain|String|debao|店铺域名|  
170 -|createPid|int|1|创建人ID|  
171 -shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|  
172 -|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|  
173 -|shopAdmin|JSON数组|||  
174 -|shopRelation|JSON数组|||  
175 -|websiteUrl|JSON数组|["www.paperworks.com.cn"]||  
176 -|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||  
177 -|shopAddress|JSON数组|||  
178 ----------------------------  
179 -  
180 -### 返回  
181 -  
182 -```json  
183 -  
184 -{  
185 - "code":200  
186 - "message":"修改成功"  
187 -}  
188 -{  
189 - "code":500  
190 - "message":"shops_id is null"  
191 -}  
192 -{  
193 - "code":500  
194 - "message":"shop_name is null"  
195 -}  
196 -{  
197 - "code":500  
198 - "message":"Sorry,店铺名已存在"  
199 -}  
200 -{  
201 - "code":500  
202 - "message":"shop_domain is null"  
203 -}  
204 -{  
205 - "code":500  
206 - "message":"Sorry,域名已存在"  
207 -}  
208 -```  
209 -  
210 -## 根据店铺名查看是否存在  
211 -  
212 -> 接口名：`/shops/checkByShopName`  
213 -  
214 -### 入参  
215 -  
216 --------------------------  
217 -|属性名称|类型|例子|说明|  
218 -|--------|----|----|----|  
219 -|shopName|String|得宝旗舰店|店铺名称|  
220 -|shopsId|int|15|店铺ID|  
221 --------------------  
222 -  
223 -### 返回  
224 -  
225 -```json  
226 -{  
227 - "code":500,  
228 - "message":"shop_name is null"  
229 -}  
230 -{  
231 - "code":500,  
232 - "message":"shops_id is null"  
233 -}  
234 -{  
235 - "code":400,  
236 - "message":"false"  
237 -}  
238 -{  
239 - "code":200,  
240 - "message":"true"  
241 -}  
242 -```  
243 -  
244 -  
245 -## 根据店铺域名查看是否存在  
246 -  
247 -> 接口名: `/shops/checkByShopDomain`  
248 -  
249 -### 入参  
250 -  
251 --------------------------  
252 -|属性名称|类型|例子|说明|  
253 -|--------|----|----|----|  
254 -|shopDomain|String|debao|店铺域名|  
255 -|shopsId|int|15|店铺ID|  
256 ------------------------------  
257 -  
258 -### 返回  
259 -  
260 -```json  
261 -  
262 -{  
263 - "code":500,  
264 - "message":"shop_name is null"  
265 -}  
266 -{  
267 - "code":500,  
268 - "message":"shops_id is null"  
269 -}  
270 -{  
271 - "code":400,  
272 - "message":"false"  
273 -}  
274 -{  
275 - "code":200,  
276 - "message":"true"  
277 -}  
278 -  
279 -```  
280 -  
281 -## 获取店铺详情  
282 -  
283 -> 接口名: `/shops/getDetailByShopId`  
284 -  
285 -### 入参  
286 -  
287 --------------------------  
288 -|属性名称|类型|例子|说明|  
289 -|--------|----|----|----|  
290 -|shopsId|int|15|店铺ID|  
291 ------------------------------  
292 -  
293 -### 返回  
294 -  
295 -```json  
296 -  
297 -{  
298 - "code":400,  
299 - "message":"店铺id有误"  
300 -}  
301 -{  
302 - "code":400,  
303 - "message":"shopInfo is none"  
304 -}  
305 -{  
306 - "code":200  
307 - "message":"ok"  
308 - "data":  
309 - {  
310 - {  
311 - "shopsId": 15,  
312 - "shopName": "",  
313 - "shopDomain": "",  
314 - "shopNature": "",  
315 - "shopLogo": "",  
316 - "websiteUrl": "",  
317 - "shopAddress": "",  
318 - "createPid": "",  
319 - "checkStatus": "",  
320 - "createTime": "",  
321 - "updateTime": "",  
322 - "status": ""  
323 - },  
324 - "shopsAdmin": [{  
325 - "id": "",  
326 - "shopsId": "",  
327 - "adminPid": "",  
328 - "identity": "",  
329 - "createTime": "",  
330 - "updateTime": ""  
331 - },{  
332 - "id": "",  
333 - "shopsId": "",  
334 - "adminPid": "",  
335 - "identity": "",  
336 - "createTime": "",  
337 - "updateTime": ""  
338 - }],  
339 - "shopRelation": [{  
340 - "id": "",  
341 - "shopsId": "",  
342 - "brandId": "",  
343 - "supplierId": "",  
344 - "createTime": "",  
345 - "updateTime": "",  
346 - "agreementEndTime": ""  
347 - },{  
348 - "id": "",  
349 - "shopsId": "",  
350 - "brandId": "",  
351 - "supplierId": "",  
352 - "createTime": "",  
353 - "updateTime": "",  
354 - "agreementEndTime": ""  
355 - }]  
356 - }  
357 - }  
358 -}  
359 -```  
360 -  
361 - 1 +# 店铺接口服务定义
  2 +---------------------
  3 +
  4 +
  5 +## 获取店铺列表
  6 +> 接口名： `/ShopsRest/getShopList`
  7 +
  8 +### 入参
  9 +
  10 +-------------------------
  11 +|属性名称|类型|例子|说明|
  12 +|--------|----|----|----|
  13 +|page|int|2|第几页|
  14 +|size|int|50|每页条数|
  15 +|supplierId|int|950|供应商ID|
  16 +|brandId|int|928|品牌ID|
  17 +|checkStatus|int|928|审核状态；100 暂存 200 待审核 300 审核通过 900 驳回|
  18 +|operationStatus|int|1|操作状态； 1 店铺未创建 2 店铺已创建|
  19 +|checkStatusArr|String|200,300|必须包含的状态|
  20 +---------------------------
  21 +
  22 +
  23 +### 返回
  24 +
  25 +```json
  26 +
  27 +{
  28 + "code": 200,
  29 + "data": {
  30 + "list": [
  31 + {
  32 + "checkStatus": 200,
  33 + "createTime": "2015-11-27 15:45:19",
  34 + "shopName": "Case Scenario",
  35 + "shopRelationList": [
  36 + {
  37 + "brandId": 409,
  38 + "brandName": "Case Scenario",
  39 + "brandNameCn": "",
  40 + "brandNameEn": "Case Scenario",
  41 + "brandStatus": 1,
  42 + "supplierId": 0,
  43 + "supplierStatus": 0
  44 + }
  45 + ],
  46 + "shopsId": 31,
  47 + "status": 1,
  48 + "updateTime": "2015-12-08 19:20:44"
  49 + }
  50 + ],
  51 + "page": 1,
  52 + "size": 10,
  53 + "total": 79,
  54 + "totalPage": 8
  55 + },
  56 + "message": "操作成功"
  57 +}
  58 +```
  59 +
  60 +---------------------------------------------------------------------------------------------------------
  61 +
  62 +## 获取店铺详情
  63 +
  64 +> 接口名: `/ShopsRest/getShopDetailById`
  65 +
  66 +### 入参
  67 +
  68 +-------------------------
  69 +|属性名称|类型|例子|说明|
  70 +|--------|----|----|----|
  71 +|shopsId|int|15|店铺ID|
  72 +-----------------------------
  73 +
  74 +### 返回
  75 +
  76 +```json
  77 +
  78 +{
  79 + "code": 200,
  80 + "data": {
  81 + "checkStatus": 200,
  82 + "createTime": "2016-01-29 23:11:00",
  83 + "otherUrl": "other,other2",
  84 + "shopAddress": "地址1,地址2",
  85 + "shopDomain": "shopDomain2311",
  86 + "shopIntro": "shopIntro",
  87 + "shopLogo": "http:///yhfairshopLogo?imageView/1/w/200/h/200",
  88 + "shopName": "店铺名称1234",
  89 + "shopNature": 1,
  90 + "shopRelationList": [
  91 + {
  92 + "agreementEndTime": "2016-03-31 00:00:00",
  93 + "brandId": 178,
  94 + "brandName": "Artanky",
  95 + "brandNameCn": "",
  96 + "brandNameEn": "Artanky ",
  97 + "brandStatus": 1,
  98 + "isFreeze": "N",
  99 + "supplierId": 480,
  100 + "supplierName": "成都朋克汉堡服装有限公司",
  101 + "supplierStatus": 300
  102 + },
  103 + {
  104 + "agreementEndTime": "2017-01-31 00:00:00",
  105 + "brandId": 355,
  106 + "brandName": "TMCAZ",
  107 + "brandNameCn": "磨叽星人",
  108 + "brandNameEn": "TMCAZ",
  109 + "brandStatus": 1,
  110 + "isFreeze": "N",
  111 + "supplierId": 310,
  112 + "supplierName": "上海贺王工贸实业公司",
  113 + "supplierStatus": 300
  114 + },
  115 + {
  116 + "agreementEndTime": "2016-12-19 00:00:00",
  117 + "brandId": 1389,
  118 + "brandName": "WWTorres",
  119 + "brandNameCn": "",
  120 + "brandNameEn": "WWTorres",
  121 + "brandStatus": 1,
  122 + "isFreeze": "N",
  123 + "supplierId": 1226,
  124 + "supplierName": "上海矩乐文化发展有限公司",
  125 + "supplierStatus": 300
  126 + }
  127 + ],
  128 + "shopsId": 454,
  129 + "shopsType": 2,
  130 + "status": 0,
  131 + "updateTime": "2016-01-29 23:27:05",
  132 + "websiteUrl": "https,https2"
  133 + },
  134 + "message": "操作成功"
  135 +}
  136 +```
  137 +
  138 +---------------------------------------------------------------------------------------------------------
  139 +
  140 +## 创建店铺
  141 +
  142 +> 接口名：`/ShopsRest/addShops`
  143 +
  144 +### 入参
  145 +
  146 +-------------------------
  147 +|属性名称|类型|例子|说明|
  148 +|--------|----|----|----|
  149 +|shopName|String|得宝旗舰店|店铺名称|
  150 +|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|
  151 +|shopDomain|String|debao|店铺域名|
  152 +|createPid|int|1|创建人ID|
  153 +|shopsType|int|1|店铺模式(1-单品店；2-多品店)|
  154 +|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|
  155 +|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|
  156 +|websiteUrl|JSON数组|["www.paperworks.com.cn"]||
  157 +|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||
  158 +|shopAddress|JSON数组|||
  159 +|onCheck|int|1|是否需要审核（1-是；0-否）|
  160 +|shopRelation|JSON数组||品牌与供应商关系|
  161 +---------------------
  162 +
  163 +shopRelation的json格式为：
  164 +``` json
  165 +
  166 +"shopRelation":[
  167 + {
  168 + "brandId":355,
  169 + "supplierId":310,
  170 + "agreementEndTime":1485792000
  171 + },
  172 + {
  173 + "brandId":1389,
  174 + "supplierId":1226,
  175 + "agreementEndTime":1482076800
  176 + }
  177 + ]
  178 +```
  179 +
  180 +### 返回
  181 +返回码code为200就是成功，其余为失败。
  182 +
  183 +``` json
  184 +{
  185 + "code": 200,
  186 + "message": "success."
  187 +}
  188 +```
  189 +
  190 +---------------------------------------------------------------------------------------------------------
  191 +
  192 +## 修改店铺
  193 +
  194 +> 接口名：`/ShopsRest/updateShops`
  195 +
  196 +### 入参
  197 +
  198 +-------------------------
  199 +|属性名称|类型|例子|说明|
  200 +|--------|----|----|----|
  201 +|shopsId|int|2|店铺id|
  202 +|shopName|String|得宝旗舰店|店铺名称|
  203 +|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|
  204 +|shopDomain|String|debao|店铺域名|
  205 +|createPid|int|1|创建人ID|
  206 +|shopsType|int|1|店铺模式(1-单品店；2-多品店)|
  207 +|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|
  208 +|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|
  209 +|websiteUrl|JSON数组|["www.paperworks.com.cn"]||
  210 +|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||
  211 +|shopAddress|JSON数组|||
  212 +|onCheck|int|1|是否需要审核（1-是；0-否）|
  213 +|shopRelation|JSON数组||品牌与供应商关系|
  214 +---------------------
  215 +
  216 +shopRelation的json格式为：
  217 +``` json
  218 +
  219 +"shopRelation":[
  220 + {
  221 + "brandId":355,
  222 + "supplierId":310,
  223 + "agreementEndTime":1485792000
  224 + },
  225 + {
  226 + "brandId":1389,
  227 + "supplierId":1226,
  228 + "agreementEndTime":1482076800
  229 + }
  230 + ]
  231 +```
  232 +
  233 +### 返回
  234 +返回码code为200就是成功，其余为失败。
  235 +
  236 +``` json
  237 +{
  238 + "code": 200,
  239 + "message": "success."
  240 +}
  241 +```
  242 +
  243 +---------------------------------------------------------------------------------------------------------
  244 +
  245 +## 关店
  246 +
  247 +> 接口名: `/ShopsRest/closeShops`
  248 +
  249 +### 入参
  250 +
  251 +-------------------------
  252 +|属性名称|类型|例子|说明|
  253 +|--------|----|----|----|
  254 +|shopsId|int|15|店铺ID|
  255 +-----------------------------
  256 +
  257 +### 返回
  258 +
  259 +```json
  260 +
  261 +{
  262 + "code": 200,
  263 + "message": "操作成功"
  264 +}
  265 +
  266 +```
  267 +
  268 +---------------------------------------------------------------------------------------------------------
  269 +
  270 +## 开店
  271 +
  272 +> 接口名: `/ShopsRest/openShops`
  273 +
  274 +### 入参
  275 +
  276 +-------------------------
  277 +|属性名称|类型|例子|说明|
  278 +|--------|----|----|----|
  279 +|shopsId|int|15|店铺ID|
  280 +-----------------------------
  281 +
  282 +### 返回
  283 +
  284 +```json
  285 +
  286 +{
  287 + "code": 200,
  288 + "message": "操作成功"
  289 +}
  290 +
  291 +```
  292 +
  293 +---------------------------------------------------------------------------------------------------------
  294 +
  295 +## 审核通过
  296 +
  297 +> 接口名: `/ShopsRest/checkShopPass`
  298 +
  299 +### 入参
  300 +
  301 +-------------------------
  302 +|属性名称|类型|例子|说明|
  303 +|--------|----|----|----|
  304 +|shopsId|int|15|店铺ID|
  305 +-----------------------------
  306 +
  307 +### 返回
  308 +
  309 +```json
  310 +
  311 +{
  312 + "code": 200,
  313 + "message": "操作成功"
  314 +}
  315 +
  316 +```
  317 +
  318 +---------------------------------------------------------------------------------------------------------
  319 +
  320 +## 审核拒绝
  321 +
  322 +> 接口名: `/ShopsRest/checkReject`
  323 +
  324 +### 入参
  325 +
  326 +-------------------------
  327 +|属性名称|类型|例子|说明|
  328 +|--------|----|----|----|
  329 +|shopsId|int|15|店铺ID|
  330 +-----------------------------
  331 +
  332 +### 返回
  333 +
  334 +```json
  335 +
  336 +{
  337 + "code": 200,
  338 + "message": "操作成功"
  339 +}
  340 +
  341 +```
  342 +
  343 +
  344 +---------------------------------------------------------------------------------------------------------
  345 +
  346 +## 根据品牌id，获取品牌供应商关系（可用的供应商，并且是合同有效的）
  347 +
  348 +> 接口名: `/supplier/supplier/selectSupplierByBrandId`
  349 +
  350 +### 入参
  351 +
  352 +-------------------------
  353 +|属性名称|类型|例子|说明|
  354 +|--------|----|----|----|
  355 +|brandId|int|15|品牌ID|
  356 +-----------------------------
  357 +
  358 +### 返回
  359 +
  360 +```json
  361 +
  362 +{
  363 + "code": 200,
  364 + "data": [
  365 + {
  366 + "agreementEndTime": "2016-10-31",
  367 + "brandId": 1409,
  368 + "supplierId": 1147,
  369 + "supplierName": "北京尚视科技有限公司"
  370 + }
  371 + ],
  372 + "message": "操作成功"
  373 +}
  374 +
  375 +```
1 -# 店铺审核接口服务定义  
2 ----------------------  
3 -  
4 -## 添加店铺审核  
5 -  
6 -> 接口名：`/shops/addCheckShop`  
7 -  
8 -### 入参  
9 -  
10 --------------------------  
11 -|属性名称|类型|例子|说明|  
12 -|--------|----|----|----|  
13 -|shopsId|int|15|店铺ID|  
14 -|shopName|String|得宝旗舰店|店铺名称|  
15 -|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|  
16 -|shopDomain|String|debao|店铺域名|  
17 -|shopRelation|JSON数组|||  
18 -|createPid|int|1|创建人ID|  
19 -|shopsType|int|1|店铺模式(1 单品店 2 多品店)|  
20 -|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|  
21 -|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|  
22 -|websiteUrl|JSON数组|["www.paperworks.com.cn"]||  
23 -|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||  
24 -|shopAddress|JSON数组|||  
25 -|status|int|0|状态(1 开启 0 关闭)|  
26 -|createTime|int|1441936854|添加时间|  
27 -|updateTime|int|1442312299|修改时间|  
28 ----------------------  
29 -  
30 -### 返回  
31 -  
32 -``` json  
33 -{  
34 - "code":400  
35 - "message":"店铺已经在审核中"  
36 -}  
37 -{  
38 - "code":500  
39 - "message":"操作成功"  
40 -}  
41 -{  
42 - "code":200  
43 - "message":"操作成功"  
44 -}  
45 -```  
46 -  
47 -  
48 -## 获取查看审核详情  
49 -> 接口名： `/shops/getCheckShopInfo`  
50 -  
51 -### 入参  
52 -  
53 --------------------------  
54 -|属性名称|类型|例子|说明|  
55 -|--------|----|----|----|  
56 -|shopsId|int|15|店铺ID|  
57 ----------------------------  
58 -  
59 -### 返回  
60 -  
61 -```json  
62 -{  
63 - "code":400  
64 - "message":"店铺id有误"  
65 -}  
66 -{  
67 - "code":500  
68 - "message":"暂无数据"  
69 -}  
70 -{  
71 - "code":200,  
72 - "message":"ok",  
73 - "data":{  
74 -  
75 - }  
76 -}  
77 -  
78 -```  
79 -  
80 -## 审核通过  
81 -> 接口名： `/shops/allowShop`  
82 -  
83 -### 入参  
84 -  
85 --------------------------  
86 -|属性名称|类型|例子|说明|  
87 -|--------|----|----|----|  
88 -|shopsId|int|15|店铺ID|  
89 ----------------------------  
90 -  
91 -### 返回  
92 -  
93 -```json  
94 -{  
95 - "code":400  
96 - "message":"店铺信息有误"  
97 -}  
98 -{  
99 - "code":500  
100 - "message":"没有待审核的信息"  
101 -}  
102 -{  
103 - "code":500  
104 - "message":"更新店铺信息失败"  
105 -}  
106 -{  
107 - "code":200  
108 - "message":"更新成功"  
109 -}  
110 -```  
111 -  
112 -## 审核驳回  
113 -  
114 -> 接口名：`/shops/rejectShop`  
115 -  
116 -### 入参  
117 -  
118 --------------------------  
119 -|属性名称|类型|例子|说明|  
120 -|--------|----|----|----|  
121 -|shopsId|int|15|店铺ID|  
122 --------------------  
123 -  
124 -### 返回  
125 -  
126 -```json  
127 -{  
128 - "code":400,  
129 - "message":"店铺信息有误"  
130 -}  
131 -{  
132 - "code":500,  
133 - "message":"没有待审核的信息"  
134 -}  
135 -{  
136 - "code":500,  
137 - "message":"操作失败"  
138 -}  
139 -{  
140 - "code":200,  
141 - "message":"操作成功",  
142 -}  
143 -```  
144 - 1 +# 店铺审核接口服务定义
  2 +---------------------
  3 +
  4 +## 添加店铺审核
  5 +
  6 +> 接口名：`/ShopsCheckRest/addCheckShop`
  7 +
  8 +### 入参
  9 +``` json
  10 +{
  11 + "shopsId":15,
  12 + "shopName":"得宝旗舰店",
  13 + "shopNature":1,
  14 + "shopDomain":"debao",
  15 + "shopRelation":[{
  16 + "brandId":355,
  17 + "supplierId":310,
  18 + "agreementEndTime":1485792000,
  19 + "method":"add"
  20 +},
  21 +{
  22 + "brandId":178,
  23 + "supplierId":480,
  24 + "agreementEndTime":1459353600,
  25 + "method":"del"
  26 +}],
  27 +"createPid":"1"
  28 +}
  29 +```
  30 +-------------------------
  31 +|属性名称|类型|例子|说明|
  32 +|--------|----|----|----|
  33 +|shopsId|int|15|店铺ID|
  34 +|shopName|String|得宝旗舰店|店铺名称|
  35 +|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|
  36 +|shopDomain|String|debao|店铺域名|
  37 +|shopRelation|JSON数组|||
  38 +|createPid|int|1|创建人ID|
  39 +|shopsType|int|1|店铺模式(1 单品店 2 多品店)|
  40 +|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|
  41 +|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|
  42 +|websiteUrl|JSON数组|["www.paperworks.com.cn"]||
  43 +|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||
  44 +|shopAddress|JSON数组|||
  45 +|status|int|0|状态(1 开启 0 关闭)|
  46 +|createTime|int|1441936854|添加时间|
  47 +|updateTime|int|1442312299|修改时间|
  48 +
  49 +注意：入参中`shopRelation`的json格式，如下：
  50 +```javascript
  51 +[{
  52 + "brandId":355,
  53 + "supplierId":310,
  54 + "agreementEndTime":1485792000,
  55 + "method":"add"
  56 +},
  57 +{
  58 + "brandId":178,
  59 + "supplierId":480,
  60 + "agreementEndTime":1459353600,
  61 + "method":"del"
  62 +}]
  63 +```
  64 +`websiteUrl`的json格式，如下：
  65 +```javascript
  66 +["网址1","网址2"]
  67 +```
  68 +`otherUrl`的json格式，如下：
  69 +```javascript
  70 +["网址1","网址2"]
  71 +```
  72 +`shopAddress`的json格式，如下：
  73 +```javascript
  74 +["地址1","地址2"]
  75 +```
  76 +---------------------
  77 +
  78 +### 返回
  79 +
  80 +``` json
  81 +{
  82 + "code":400
  83 + "message":"shopsId is required"
  84 +}
  85 +{
  86 + "code":400
  87 + "message":"shopName is required"
  88 +}
  89 +{
  90 + "code":400
  91 + "message":"shopNature is required"
  92 +}
  93 +{
  94 + "code":400
  95 + "message":"shopDomain is required"
  96 +}
  97 +{
  98 + "code":400
  99 + "message":"shopRelation is required"
  100 +}
  101 +{
  102 + "code":400
  103 + "message":"createPid is required"
  104 +}
  105 +{
  106 + "code":400
  107 + "message":"店铺已经在审核中"
  108 +}
  109 +{
  110 + "code":200
  111 + "message":"操作成功"
  112 +}
  113 +```
  114 +
  115 +
  116 +## 获取查看审核详情
  117 +> 接口名： `/ShopsCheckRest/getCheckShopInfo`
  118 +
  119 +### 入参
  120 +```json
  121 +{
  122 + "shopsId":20
  123 +}
  124 +```
  125 +-------------------------
  126 +|属性名称|类型|例子|说明|
  127 +|--------|----|----|----|
  128 +|shopsId|int|15|店铺ID|
  129 +---------------------------
  130 +
  131 +### 返回
  132 +
  133 +```json
  134 +{
  135 + "code":400
  136 + "message":"店铺id有误"
  137 +}
  138 +{
  139 + "code":500
  140 + "message":"暂无数据"
  141 +}
  142 +{
  143 + "code": 200,
  144 + "data": {
  145 + "createPid": 1,
  146 + "createTime": 1454205517,
  147 + "examineStatus": 0,
  148 + "isRead": 1,
  149 + "operationStatus": 1,
  150 + "otherUrl": "",
  151 + "shopAddress": "",
  152 + "shopDomain": "debao",
  153 + "shopIntro": "",
  154 + "shopLogo": "",
  155 + "shopName": "得宝旗舰店",
  156 + "shopNature": 0,
  157 + "shopRelation": "[{\"agreementEndTime\":1485792000,\"brandId\":355,\"method\":\"add\",\"supplierId\":310},{\"agreementEndTime\":1459353600,\"brandId\":178,\"method\":\"del\",\"supplierId\":480}]",
  158 + "shopsId": 15,
  159 + "shopsType": 1,
  160 + "status": 0,
  161 + "updateTime": 1454205517,
  162 + "websiteUrl": ""
  163 + },
  164 + "message": "ok"
  165 +}
  166 +
  167 +```
  168 +
  169 +## 审核通过
  170 +> 接口名： `/ShopsCheckRest/allowShop`
  171 +
  172 +### 入参
  173 +```json
  174 +{
  175 + "shopsId":15
  176 +}
  177 +```
  178 +-------------------------
  179 +|属性名称|类型|例子|说明|
  180 +|--------|----|----|----|
  181 +|shopsId|int|15|店铺ID|
  182 +---------------------------
  183 +
  184 +### 返回
  185 +
  186 +```json
  187 +{
  188 + "code":400
  189 + "message":"店铺信息有误"
  190 +}
  191 +{
  192 + "code":500
  193 + "message":"没有待审核的信息"
  194 +}
  195 +{
  196 + "code":500
  197 + "message":"更新店铺信息失败"
  198 +}
  199 +{
  200 + "code":200
  201 + "message":"更新成功"
  202 +}
  203 +```
  204 +
  205 +## 审核驳回
  206 +
  207 +> 接口名：`/ShopsCheckRest/rejectShop`
  208 +
  209 +### 入参
  210 +```json{
  211 + "shopsId":15
  212 +}
  213 +```
  214 +-------------------------
  215 +|属性名称|类型|例子|说明|
  216 +|--------|----|----|----|
  217 +|shopsId|int|15|店铺ID|
  218 +-------------------
  219 +
  220 +### 返回
  221 +
  222 +```json
  223 +{
  224 + "code":400,
  225 + "message":"店铺信息有误"
  226 +}
  227 +{
  228 + "code":500,
  229 + "message":"没有待审核的信息"
  230 +}
  231 +{
  232 + "code":500,
  233 + "message":"操作失败"
  234 +}
  235 +{
  236 + "code":200,
  237 + "message":"操作成功",
  238 +}
  239 +```
  240 +