shops.md 12.3 KB

店铺接口服务定义


获取店铺列表

接口名: /ShopsRest/getShopList

入参



//店铺创建列表
{
    "page":1,//可选
    "size":10,//可选
    "supplierId":0,//可选
    "brandId":0,//可选
    "checkStatus":0,//可选
    "operationStatus":1,
    "checkStatusArr":"100,200,900"
}

//店铺信息管理列表
{
    "page":1,//可选
    "size":10,//可选
    "supplierId":0,//可选
    "brandId":0,//可选
    "checkStatus":0,//可选
    "operationStatus":2,
    "checkStatusArr":"200,300,900"
}
/Data/logs/union

//店铺审核列表
{
    "page":1,//可选
    "size":10,//可选
    "supplierId":0,//可选
    "brandId":0,//可选
    "checkStatus":200,
    "operationStatus":0,
    "checkStatusArr":"200"
}

属性名称 类型 例子 说明
page int 1 第几页
size int 50 每页条数
supplierId int 950 供应商ID
brandId int 928 品牌ID
checkStatus int 100 审核状态;100 暂存 200 待审核 300 审核通过 900 驳回
operationStatus int 1 操作状态; 1 店铺未创建 2 店铺已创建
checkStatusArr String 200,300 必须包含的状态

返回


{
  "code": 200,
  "data": {
    "list": [
      {
        "checkStatus": 900,
        "createTime": "2016-02-26",
        "shopName": "预生产",
        "shopNature": 0,
        "shopRelationList": [
          {
            "agreementEndTime": 0,
            "brandId": 1499,
            "brandName": "标哥",
            "brandNameEn": "标哥",
            "brandStatus": 1,
            "id": 1,
            "status": 0,
            "supplierId": 0,
            "supplierStatus": 0
          }
        ],
        "shopsId": 582,
        "shopsType": 0,
        "status": 0,
        "updateTime": "2016-02-26"
      },
      {
        "checkStatus": 900,
        "createTime": "2016-02-25",
        "shopName": "店铺123abc",
        "shopNature": 0,
        "shopRelationList": [
          {
            "agreementEndTime": 0,
            "brandId": 1492,
            "brandName": "茶",
            "brandNameEn": "C",
            "brandStatus": 0,
            "id": 2,
            "status": 0,
            "supplierId": 0,
            "supplierStatus": 0
          }
        ],
        "shopsId": 571,
        "shopsType": 0,
        "status": 0,
        "updateTime": "2016-02-25"
      }
    ],
    "page": 1,
    "size": 10,
    "total": 79,
    "totalPage": 8
  },
  "message": "操作成功"
}

获取店铺详情

接口名:

创建店铺的列表中,点击详情和编辑的url:/ShopsRest/getShopDetailById 查询的是check表
审核店铺的列表中,点击详情和编辑的url:/ShopsRest/getShopDetailById 查询的是check表
店铺信息管理列表中,点查看的url:/ShopsCheckRest/getLastCheckShopInfoById 查询的是店铺表,该表的数据是已经审核通过的或者是曾经审核通过的数据
店铺信息管理列表中,点编辑的url:/ShopsRest/getShopDetailById 查询的是check表

入参


属性名称 类型 例子 说明
shopsId int 15 店铺ID

返回


{
  "code": 200,
  "data": {
    "checkStatus": 200,
    "createTime": "2016-01-29 23:11:00",
    "otherUrl": "other,other2",
    "shopAddress": "地址1,地址2",
    "shopDomain": "shopDomain2311",
    "shopIntro": "shopIntro",
    "shopLogo": "http:///yhfairshopLogo?imageView/1/w/200/h/200",
    "shopName": "店铺名称1234",
    "shopNature": 1,
    "shopRelationList": [
      {
        "id":1,
        "agreementEndTime": "2016-03-31 00:00:00",
        "brandId": 178,
        "brandName": "Artanky",
        "brandNameCn": "",
        "brandNameEn": "Artanky ",
        "brandStatus": 1,
        "isFreeze": "N",
        "supplierId": 480,
        "supplierName": "成都朋克汉堡服装有限公司",
        "supplierStatus": 300,
        "method":"add"
      },
      {
        "id":2,
        "agreementEndTime": "2017-01-31 00:00:00",
        "brandId": 355,
        "brandName": "TMCAZ",
        "brandNameCn": "磨叽星人",
        "brandNameEn": "TMCAZ",
        "brandStatus": 1,
        "isFreeze": "N",
        "supplierId": 310,
        "supplierName": "上海贺王工贸实业公司",
        "supplierStatus": 300,
        "method":"delete"
      },
      {
        "id":13,
        "agreementEndTime": "2016-12-19 00:00:00",
        "brandId": 1389,
        "brandName": "WWTorres",
        "brandNameCn": "",
        "brandNameEn": "WWTorres",
        "brandStatus": 1,
        "isFreeze": "N",
        "supplierId": 1226,
        "supplierName": "上海矩乐文化发展有限公司",
        "supplierStatus": 300,
        "method":""
      }
    ],
    "shopsId": 454,
    "shopsType": 2,
    "status": 0,
    "updateTime": "2016-01-29 23:27:05",
    "websiteUrl": "https,https2"
  },
  "message": "操作成功"
}

创建店铺

接口名:/ShopsRest/addShops

入参


属性名称 类型 例子 说明
shopName String 得宝旗舰店 店铺名称
shopNature int 1 店铺性质(1 旗舰店 2 专卖店)
shopDomain String debao 店铺域名
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数组
onCheck int 1 是否需要审核(1-是;0-否)
shopRelation JSON数组 品牌与供应商关系

shopRelation的json格式为:


"shopRelation":[
        {
            "method":"add",
            "brandId":355,
            "brandName":"TMCAZ",
            "supplierId":310,
            "supplierName":"上海贺王工贸实业公司",
            "agreementEndTime":1485792000
        },
        {
            "method":"add",
            "brandId":1389,
            "brandName":"WWTorres",
            "supplierId":1226,
            "supplierName":"上海矩乐文化发展有限公司",
            "agreementEndTime":1482076800
        }
    ]

返回

返回码code为200就是成功,其余为失败。

{
  "code": 200,
  "message": "success."
}

修改店铺

接口名:/ShopsRest/updateShops

入参


属性名称 类型 例子 说明
shopsId int 2 店铺id
shopName String 得宝旗舰店 店铺名称
shopNature int 1 店铺性质(1 旗舰店 2 专卖店)
shopDomain String debao 店铺域名
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数组
onCheck int 1 是否需要审核(1-是;0-否)
shopRelation JSON数组 品牌与供应商关系

shopRelation的json格式为:


"shopRelation":[
        {
            "id":737,
            "method":"delete",
            "brandId":355,
            "brandName":"TMCAZ",
            "supplierId":310,
            "supplierName":"上海贺王工贸实业公司",
            "agreementEndTime":1485792000
        },
        {
            "id":738,
            "method":"",
            "brandId":1389,
            "brandName":"WWTorres",
            "supplierId":1226,
            "supplierName":"上海矩乐文化发展有限公司",
            "agreementEndTime":1482076800
        },
        {
            "method":"add",
            "brandId":1480,
            "brandName":"满了",
            "supplierId":1348,
            "supplierName":"满了吧",
            "agreementEndTime":1482076800
        }
    ]

其中的method字段 add-新增 delete-删除 为空-则为无变化

返回

返回码code为200就是成功,其余为失败。

{
  "code": 200,
  "message": "success."
}

关店

接口名: /ShopsRest/closeShops

入参


属性名称 类型 例子 说明
shopsId int 15 店铺ID

返回


{
  "code": 200,
  "message": "操作成功"
}

开店

接口名: /ShopsRest/openShops

入参


属性名称 类型 例子 说明
shopsId int 15 店铺ID

返回


{
  "code": 200,
  "message": "操作成功"
}

审核通过

接口名: /ShopsRest/checkShopPass

入参


属性名称 类型 例子 说明
shopsId int 15 店铺ID

返回


{
  "code": 200,
  "message": "操作成功"
}

审核拒绝

接口名: /ShopsRest/checkReject

入参


属性名称 类型 例子 说明
shopsId int 15 店铺ID

返回


{
  "code": 200,
  "message": "操作成功"
}

根据品牌id,获取品牌供应商关系(可用的供应商,并且是合同有效的)

接口名: /supplier/supplier/selectSupplierByBrandId

入参

{
    "brandId":1409
}

属性名称 类型 例子 说明
brandId int 15 品牌ID

返回


{
  "code": 200,
  "data": {
    "list": [
      {
        "agreementEndTime": 1456675200,
        "brandId": 1409,
        "supplierId": 1301,
        "supplierName": "腾讯"
      },
      {
        "agreementEndTime": 1477843200,
        "brandId": 1409,
        "supplierId": 1147,
        "supplierName": "北京尚视科技有限公司"
      }
    ]
  },
  "message": "操作成功"
}

查询所有已经审核通过的店铺

接口名: /ShopsRest/selectCheckPassShopsByName

入参

{
    "idName":"速写CROQUIS"
}
or
{

}

注意 入参为{},查询所有店铺


属性名称 类型 例子 说明
idName String 速写CROQUIS 店铺名称

返回


{
  "code": 200,
  "data": [
    {
      "checkStatus": 0,
      "createTime": "",
      "id": 22,
      "shopNature": 0,
      "shopsType": 0,
      "status": 0,
      "text": "速写CROQUIS",
      "updateTime": ""
    }
  ],
  "message": "操作成功"
}