Authored by 马力
## 1、新增基础商品##
新增基础商品(/SellerProductController/addProduct)
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|productName|string|否|商品名称|名称|
|brandId|int|否|22|品牌的ID号|
|maxSortId|int|否|1|一级品类的Id|
|middleSortId|int|否|22|二级品类的ID|
|smallSortId|int|否|33|三级品类的ID|
|gender|string|否|1|1代表男 2代表女 3代表通用|
|factoryCode|string|是|厂家编码|厂家编码|
|retailPrice|double|否|188.00|吊牌价|
|salesPrice|double|否|188.00|销售价|
|goodsYears|int|否|2018|商品年|
|phrase|string|是|卖点|卖点|
|goodsSeason|int|否|1|货品季 1代表春 2夏 3秋 4冬 5春夏 6秋冬|
|ageLevel|string|否|1|年龄层1成人2大童3小童 4中童 5幼童 多选用单竖线分隔 |
|seasons|string|否|spring|是|适销季spring春秋summer夏 winter冬 seasons四季|
|sellerGoodsInfoStr|string|否|商品信息|json串|商品颜色尺码列表|
## 商品颜色的参数说明##
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|factoryCode|string|是|款型编码|编码|
|factoryGoodsName|string|否|亚红色|颜色展示名称|
|goodsName|string|否|红色|色系名称|
|colorId|int|否|22|色系ID|
|isDefault|string|否|Y|是否主推,不是则传N|
|goodsColorImage|string|否|图片的url|图片的绝对路径|
|goodsSizeList|string|是|JSON串|当前颜色下面尺码列表json|
## 尺码的参数说明##
| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|----:|
|factoryCode|string|是|条码|条码|
|sizeId|int|是|22|尺码ID|
注意,通用的头部没有列出。
请求示例
http://127.0.0.1:8088/platform/SellerProductController/addProduct
## 请求样例数据
``` json
请求样例:
{"productName":"商品名", "brandId":4, "maxSortId":12, "middleSortId" : 144, "smallSortId":145 , "gender" : "1", "retailPrice":"44.44", "salesPrice": "33.33", "phrase" :"商品卖点",
"goodsYears":2019, "goodsSeason":1, "factoryCode":"厂家编号", "ageLevel":"1|2", "seasons":"1", "sellerGoodsInfoStr" : "[{\"factoryCode\":\"123123123\",\"factoryGoodsName\":\"蓝色1111\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/02c52592f14a13be1014aa8c116b5d4e1c.jpg\",\"goodsName\":\"蓝色\",\"colorId\":36,\"goodsSizeList\":[{\"sizeId\":\"203\",\"factoryCode\":\"12dad%%\"},{\"sizeId\":\"207\",\"factoryCode\":\"adasd%%\"}],\"isDefault\":\"N\"},{\"factoryCode\":\"aas23123\",\"factoryGoodsName\":\"蓝色3333\",\"goodsColorImage\":\"http://img12.static.yhbimg.com/goodsimg/2017/04/18/11/028adf5dd962895c11feb2fec8ef0c5b32.jpg\",\"goodsName\":\"蓝色\",\"colorId\":33,\"goodsSizeList\":[{\"sizeId\":\"207\",\"factoryCode\":\"asdasd$$\"},{\"sizeId\":\"203\",\"factoryCode\":\"##sdasd\"}],\"isDefault\":\"Y\"}]"
}
正常返回:
{
"code": 200,
"data": [],
"md5": "d751713988987e9331980363e24189ce",
"message": "添加成功"
}
异常返回:
{
"code": 1001,
"data": ["错误一", "错误二"],
"md5": "d751713988987e9331980363e24189ce",
"message": "参数校验错误"
}
```
\ No newline at end of file
... ...
## 1. 根据品类查询所有关联的尺码
GET /SellerSortSizeController/querySortSize
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|sortId|int|是|1|品类id|
#### 返回:
{
"code": 200,
"data": [
{
"id": 2108,
"sizeName": "尺码2测试"
},
{
"id": 2106,
"sizeName": "木木02"
},
{
"id": 563,
"sizeName": "关联64级"
}
],
"md5": "2377c4bc49e970d847896b95a166604d",
"message": "查询成功."
}
## 2. 根据店铺、品牌查询供应商
GET /SellerShopsBrandsController/querySupplier
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|shopsId|int|是|18|店铺id|
|brandId|int|是|2454|品牌id|
#### 返回:
{
"code": 200,
"data": [
{
"id": 1702,
"supplierCode": "123123323234",
"supplierName": "阿迪供应商"
}
],
"md5": "aad0b679a2fce50347b623db5c9bfaca",
"message": "查询成功."
}
## 3. 根据品类查询风格、图案纹理,制作工艺
GET /SellerProductAttributeController/selectAttributes
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|saleType|int|是|2|1:销售属性 2:非销售属性 3:扩展属性|
|categoryId|int|是|114|品类id|
|displayPosition|int|是|2|1:基础商品-非销售属性 2:网销信息-上架后补全信息 3:网销信息-商品参数|
#### 返回:
{
"code": 200,
"data": [
{
"attributeId": 115,
"attributeName": "制作工艺",
"attributeValues": "[{\"id\":1,\"name\":\"镶边\"},{\"id\":2,\"name\":\"贴布\"},...]",
"categoryId": 1,
"createTime": 1459906085,
"displayPosition": 2,
"idNameList": [
{
"id": "1",
"text": "镶边"
},
{
"id": "2",
"text": "贴布"
},
...
],
"inputType": "checkbox",
"isSearch": "",
"orderBy": 111,
"saleType": 2
},
{
"attributeId": 29,
"attributeName": "图案纹理",
"attributeValues": "[{\"id\":1,\"name\":\"条纹\"},{\"id\":2,\"name\":\"海魂\"},...]",
"belong": 10,
"categoryId": 1,
"createTime": 0,
"displayPosition": 2,
"idNameList": [
{
"id": "1",
"text": "条纹"
},
{
"id": "2",
"text": "海魂"
},
...
],
"inputType": "checkbox",
"isAllowAlias": "Y",
"isColor": "N",
"isMust": "N",
"isSearch": "Y",
"maxValueLen": 25,
"orderBy": 0,
"saleType": 2,
"state": 1
},
{
"attributeId": 2016,
"attributeName": "风格",
"attributeValues": "[{\"id\":989,\"name\":\"运动\"},{\"id\":990,\"name\":\"户外\"},...]",
"belong": 10,
"categoryId": 1,
"createTime": 0,
"displayPosition": 2,
"idNameList": [
{
"id": "989",
"text": "运动"
},
{
"id": "990",
"text": "户外"
},
...
],
"inputType": "checkbox",
"isAllowAlias": "Y",
"isColor": "N",
"isMust": "N",
"isSearch": "Y",
"maxValueLen": 25,
"orderBy": 0,
"saleType": 2,
"state": 1
}
],
"md5": "fe7bc02e2d4639ef4f962667e6c0f297",
"message": "商品添加成功."
}
## 4. 查询商品的洗涤提示、材质、舒适度
GET /SellerProductSpecialAttrController/queryProductSpecialAttrByProductId
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|productId|int|是|11056||
#### 返回:
{
"code": 200,
"data": {
"materialList": [
{
"id": 10
}
],
"productId": 11056,
"sizeStandard": 1,
"washTipsList": [
{
"sortId": 2
},
...
],
"wearSenses": [
{
"id": 1,
"value": 3
},
...
]
},
"md5": "614646bd3b0a301e02e61faaa769a19d",
"message": "查询成功."
}
## 5. 查询商品描述
GET SellerProductIntroController/queryProductIntroByProductId
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 |
|:-------| -----:|-----:|-----:|
|productId|int|是|1|
#### 返回:
{
"code": 200,
"data": {
"productId": 1,
"productIntro": "sdas<p>11134444411</p>"
},
"md5": "246d7376b018dcc28a68a392cb19c633",
"message": "查询成功."
}
## 6. 根据品类查询商品参数列表
GET /SellerStandardController/queryProductParamBySortId
#### 请求参数
| 参数名称 | 参数类型 | 必填 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|sortId|int|是|114|品类id|
#### 返回:
{
"code": 200,
"data": [
{
"attributeId": 981,
"attributeName": "袖型",
"attributeValues": "[{\"id\":5363,\"name\":\"灯笼袖\"},...]",
"categoryId": 114,
"idNameList": [
{
"id": "5363",
"text": "灯笼袖"
},
...
],
"inputType": "select"
},
{
"attributeId": 788,
"attributeName": "衣长",
"attributeValues": "[{\"id\":4444,\"name\":\"短款\"},{\"id\":4445,\"name\":\"适中\"},{\"id\":4446,\"name\":\"长款\"}]",
"categoryId": 114,
"idNameList": [
{
"id": "4444",
"text": "短款"
},
{
"id": "4445",
"text": "适中"
},
{
"id": "4446",
"text": "长款"
}
],
"inputType": "select"
},
...
],
"md5": "dad29d8ef986bde22a608869c3981c0f",
"message": "成功"
}
... ...
## 1、查询店铺品牌##
查询店铺品牌(/SellerProductController/getSellerBrandInfo)
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|shopsId|int|否|店铺id||
注意,通用的头部没有列出。
请求示例
http://127.0.0.1:8088/platform/SellerProductController/getSellerBrandInfo?shopsId=18
## 请求样例数据
``` json
正常返回:
{
"code": 200,
"data": [
{
"brandName": "10x188",
"brandId": 2
},
{
"brandName": "中国阿迪",
"brandId": 2454
}
],
"md5": "8b233b3ba501d3563be331aa58d0fe0d",
"message": "查询品牌成功."
}
异常返回:
{
"code": 400,
"data": [],
"md5": "d751713988987e9331980363e24189ce",
"message": "店铺id错误"
}
{
"code": 500,
"data": [],
"md5": "8b233b3ba501d3563be331aa58d0fe0d",
"message": "查询品牌失败:错误信息."
}
```
## 2、查询品类信息##
查询品类信息(/SellerProductController/getSellerSortInfo)
#### 请求参数
| 参数名称 | 参数类型 | 可否为空 | 示例 | 备注 |
|:-------| -----:|-----:|-----:|----:|
|shopsId|int|否|店铺id||
|brandId|int|否|22|品牌的ID号|
|sortId|int|是|22|父类别的ID号|
|level|int|否|1|第几级分类|
注意,通用的头部没有列出。
如果查询所有一级分类,shopsId,brandId传值,level传1,sortId不传
如果查询某级分类的子分类,shopsId,brandId传值,level传子分类级别,sortId某分类id
请求示例
http://127.0.0.1:8088/platform/SellerProductController/getSellerSortInfo?shopsId=18&brandId=2454&level=1
## 请求样例数据
``` json
正常返回:
{
"code": 200,
"data": [
{
"sortName": "上衣",
"sortId": 1
},
{
"sortName": "裤装",
"sortId": 3
},
{
"sortName": "鞋靴",
"sortId": 6
},
{
"sortName": "服配",
"sortId": 8
},
{
"sortName": "创意生活",
"sortId": 10
},
{
"sortName": "内衣/家居服",
"sortId": 308
},
{
"sortName": "泳衣",
"sortId": 360
},
{
"sortName": "平台化一期一级5555555555555555533",
"sortId": 574
}
],
"md5": "668200aa58d71c1b2f3e1e641ca408be",
"message": "查询品类成功."
}
异常返回:
{
"code": 400,
"data": [],
"md5": "d751713988987e9331980363e24189ce",
"message": "店铺id错误"
}
{
"code": 500,
"data": [],
"md5": "8b233b3ba501d3563be331aa58d0fe0d",
"message": "查询品类失败:错误信息."
}
```
\ No newline at end of file
... ...