lingmin / yohobuy-doc · Commits

Go to a project

Authored by qianjun
Commit 8dd0ecc107cc78eff4513d72805ba5786b84cedd 1 parent 4c6c1f4e

店铺相关接口

Inline Side-by-side
Showing 2 changed files with 314 additions and 0 deletions
# 店铺管理员接口服务定义
---------------------
## 获取店铺管理员列表
> 接口名：`/shops/getShopsAdminList`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|page|int|2|第几页|
|size|int|50|每页条数|
---------------------
### 返回
``` json
{
"code":200,
"message":"list",
"data":{
}
}
```
## 添加店铺管理员关系
> 接口名： `/shops/addAdminRelation`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopsId|int|15|店铺ID|
|adminPid|int|2951|管理员ID|
|identity|int|1|身份(1、店长 2、供应商 3、店员)|
---------------------------
### 返回
```json
{
"code":500
"message":"shops_id is null"
}
{
"code":500
"message":"admin_pid is null"
}
{
"code":500
"message":"该关系已存在"
}
{
"code":500
"message":"添加失败"
}
{
"code":200
"message":"添加成功"
}
```
## 删除店铺管理员关系
> 接口名： `/shops/delAdminRelation`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|id|int|20|店铺管理员记录ID|
|shopsId|int|15|店铺ID|
---------------------------
### 返回
```json
{
"code":500
"message":"id is null"
}
{
"code":200
"message":"删除成功!"
}
```
## 获取管理员关系详情
> 接口名：`/shops/getAdminRelationDetailById`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|id|int|20|店铺管理员记录ID|
|shopsId|int|15|店铺ID|
-------------------
### 返回
```json
{
"code":500,
"message":"id is null"
}
{
"code":500,
"message":"shops_id is null"
}
{
"code":500,
"message":"暂无数据"
}
{
"code":200,
"message":"list",
"data":{
}
}
```
## 修改店铺管理员关系
> 接口名: `/shops/updateAdminRalation`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopDomain|String|debao|店铺域名|
|shopsId|int|15|店铺ID|
-----------------------------
### 返回
```json
{
"code":500
"message":"id is null"
}
{
"code":500
"message":"shops_id is null"
}
{
"code":500
"message":"admin_pid is null"
}
{
"code":500
"message":"该关系已存在"
}
{
"code":200
"message":"修改成功"
}
```
... ...
# 店铺审核接口服务定义
---------------------
## 添加店铺审核
> 接口名：`/shops/addCheckShop`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopsId|int|15|店铺ID|
|shopName|String|得宝旗舰店|店铺名称|
|shopNature|int|1|店铺性质(1 旗舰店 2 专卖店)|
|shopDomain|String|debao|店铺域名|
|shopRelation|JSON数组|||
|createPid|int|1|创建人ID|
|shopsType|int|1|店铺模式(1 单品店 2 多品店)|
|shopLogo|String|http://img11.static.yhbimg.com/yhb-img01/2015/09/11/02/01f42dff5d5bd383af1025eea1218cbccc.jpg?imageView/{mode}/w/{width}/h/{height}|店铺logo|
|shopIntro|String|秉承以设计为核心的创新理念，用专业的思维方式将自然与科技、传统与革新、技艺与时尚三者良好融合，着重面料材质与软式廓型的品质互动，更好的诠释“less is more”的设计理念。|店铺简介|
|websiteUrl|JSON数组|["www.paperworks.com.cn"]||
|otherUrl|JSON数组|["www.paperworks.com.cn","https:\/\/jnby.tmall.com\/"]||
|shopAddress|JSON数组|||
|status|int|0|状态(1 开启 0 关闭)|
|createTime|int|1441936854|添加时间|
|updateTime|int|1442312299|修改时间|
---------------------
### 返回
``` json
{
"code":400
"message":"店铺已经在审核中"
}
{
"code":500
"message":"操作成功"
}
{
"code":200
"message":"操作成功"
}
```
## 获取查看审核详情
> 接口名： `/shops/getCheckShopInfo`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopsId|int|15|店铺ID|
---------------------------
### 返回
```json
{
"code":400
"message":"店铺id有误"
}
{
"code":500
"message":"暂无数据"
}
{
"code":200,
"message":"ok",
"data":{
}
}
```
## 审核通过
> 接口名： `/shops/allowShop`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopsId|int|15|店铺ID|
---------------------------
### 返回
```json
{
"code":400
"message":"店铺信息有误"
}
{
"code":500
"message":"没有待审核的信息"
}
{
"code":500
"message":"更新店铺信息失败"
}
{
"code":200
"message":"更新成功"
}
```
## 审核驳回
> 接口名：`/shops/rejectShop`
### 入参
-------------------------
|属性名称|类型|例子|说明|
|--------|----|----|----|
|shopsId|int|15|店铺ID|
-------------------
### 返回
```json
{
"code":400,
"message":"店铺信息有误"
}
{
"code":500,
"message":"没有待审核的信息"
}
{
"code":500,
"message":"操作失败"
}
{
"code":200,
"message":"操作成功",
}
```
... ...