谷粒商城项目接口文档

傷城~ 2022-12-31 01:15 428阅读 0赞

文章目录

  • 一、后台管理系统接口
    • 公共模型
      • 01、分页请求数据
      • 02、分页返回数据
    • 商品系统
      • 01、获取所有分类及子分类
      • 02、修改分类父子关系以及顺序
      • 03、获取分类属性分组
      • 04、获取属性分组详情
      • 05、获取分类规格参数
      • 06、保存属性【规格参数，销售属性】
      • 07、查询属性详情
      • 08、修改属性
      • 09、获取分类销售属性
      • 10、获取属性分组的关联的所有属性
      • 11、添加属性与分组关联关系
      • 12、删除属性与分组的关联关系
      • 13、获取属性分组没有关联的其他属性
      • 14、获取分类关联的品牌
      • 15、获取品牌关联的分类
      • 16、新增品牌与分类关联关系
      • 17、获取分类下所有分组&关联属性
      • 18、spu检索
      • 19、新增商品
      • 20、商品上架
      • 21、sku检索
      • 22、获取spu规格
      • 23、修改商品规格
    • 订单系统
    • 用户系统
      • 01、获取所有会员等级
    • 库存系统
      • 01、仓库列表
      • 02、查询商品库存
      • 03、查询采购需求
      • 04、合并采购需求
      • 05、查询未领取的采购单
      • 06、领取采购单
      • 07、完成采购
    • 优惠系统
      • 01、获取优惠券
    • 第三方服务
      • 01、获取对象存储服务端签名
  • 二、商城系统接口
    • 首页
    • 商品
      • 01、商品检索
    • 个人中心
    • 购物车
    • 订单支付

一、后台管理系统接口

公共模型

01、分页请求数据

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

02、分页返回数据

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": {  
  5.         "totalCount": 0, //总记录数
  6.         "pageSize": 10,  //每页大小
  7.         "totalPage": 0,  //总页码
  8.         "currPage": 1, //当前页码
  9.         "list": [{   //当前页所有数据
  10.             "brandId": 1,
  11.             "name": "aaa",
  12.             "logo": "abc",
  13.             "descript": "华为",
  14.             "showStatus": 1,
  15.             "firstLetter": null,
  16.             "sort": null
  17.         }]
  18.     }
  19. }

商品系统

01、获取所有分类及子分类

请求方式：

  1. GET

请求地址：

  1. /product/category/list/tree

接口描述：

获取所有分类以及子分类，并返回json树形结构

响应参数：

在这里插入图片描述

data：

在这里插入图片描述
响应示例：

  1. { 
  2.     "code": 0,
  3.     "msg": "success",
  4.     "data": [{ 
  5.         "catId": 1,
  6.         "name": "图书、音像、电子书刊",
  7.         "parentCid": 0,
  8.         "catLevel": 1,
  9.         "showStatus": 1,
  10.         "sort": 0,
  11.         "icon": null,
  12.         "productUnit": null,
  13.         "productCount": 0,
  14.         "children": []
  15.     }]
  16. }

02、修改分类父子关系以及顺序

请求方式：

  1. POST

请求地址：

  1. /product/category/update/sort

请求参数：

  1. [
  2.   { 
  3.     "catId": 0, //菜单id
  4.     "catLevel": 0, //菜单层级
  5.     "parentCid": 0, //父菜单id
  6.     "sort": 0 //排序
  7.   }
  8. ]

注意：没有修改的字段无需携带

响应数据：

  1. { 
  2.   "msg": "success",
  3.   "code": 0
  4. }

03、获取分类属性分组

请求方式：

  1. GET

请求地址：

  1. /product/attrgroup/list/{ catelogId}

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "attrGroupId": 0, //分组id
  11.             "attrGroupName": "string", //分组名
  12.             "catelogId": 0, //所属分类
  13.             "descript": "string", //描述
  14.             "icon": "string", //图标
  15.             "sort": 0 //排序
  16.             "catelogPath": [2,45,225] //分类完整路径
  17.         }]
  18.     }
  19. }

04、获取属性分组详情

请求方式：

  1. GET

请求地址：

  1. /product/attrgroup/info/{ attrGroupId}

响应数据：

  1. { 
  2.     "code": 0,
  3.     "msg": "success",
  4.     "attrGroup": { 
  5.         "attrGroupId": 1,
  6.         "attrGroupName": "主体",
  7.         "sort": 0,
  8.         "descript": null,
  9.         "icon": null,
  10.         "catelogId": 225,
  11.         "catelogPath": [
  12.             2,
  13.             34,
  14.             225
  15.         ] //完整分类路径
  16.     }
  17. }

05、获取分类规格参数

请求方式：

  1. GET

请求地址：

  1. /product/attr/base/list/{ catelogId}

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "attrId": 0, //属性id
  11.             "attrName": "string", //属性名
  12.             "attrType": 0, //属性类型，0-销售属性，1-基本属性
  13.             "catelogName": "手机/数码/手机", //所属分类名字
  14.             "groupName": "主体", //所属分组名字
  15.             "enable": 0, //是否启用
  16.             "icon": "string", //图标
  17.             "searchType": 0,//是否需要检索[0-不需要，1-需要]
  18.             "showDesc": 0,//是否展示在介绍上；0-否 1-是
  19.             "valueSelect": "string",//可选值列表[用逗号分隔]
  20.             "valueType": 0//值类型[0-为单个值，1-可以选择多个值]
  21.         }]
  22.     }
  23. }

06、保存属性【规格参数，销售属性】

请求方式：

  1. POST

请求地址：

  1. /product/attr/save

请求参数：

  1. { 
  2.   "attrGroupId": 0, //属性分组id
  3.   "attrName": "string",//属性名
  4.   "attrType": 0, //属性类型
  5.   "catelogId": 0, //分类id
  6.   "enable": 0, //是否可用 
  7.   "icon": "string", //图标
  8.   "searchType": 0, //是否检索
  9.   "showDesc": 0, //快速展示
  10.   "valueSelect": "string", //可选值列表
  11.   "valueType": 0 //可选值模式
  12. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

07、查询属性详情

请求方式：

  1. GET

请求地址：

  1. /product/attr/info/{ attrId}

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "attr": { 
  5.         "attrId": 4,
  6.         "attrName": "aad",
  7.         "searchType": 1,
  8.         "valueType": 1,
  9.         "icon": "qq",
  10.         "valueSelect": "v;q;w",
  11.         "attrType": 1,
  12.         "enable": 1,
  13.         "showDesc": 1,
  14.         "attrGroupId": 1, //分组id
  15.         "catelogId": 225, //分类id
  16.         "catelogPath": [2, 34, 225] //分类完整路径
  17.     }
  18. }

08、修改属性

请求方式：

  1. POST

请求地址：

  1. /product/attr/update

请求参数：

  1. { 
  2.   "attrId": 0, //属性id
  3.   "attrGroupId": 0, //属性分组id
  4.   "attrName": "string",//属性名
  5.   "attrType": 0, //属性类型
  6.   "catelogId": 0, //分类id
  7.   "enable": 0, //是否可用 
  8.   "icon": "string", //图标
  9.   "searchType": 0, //是否检索
  10.   "showDesc": 0, //快速展示
  11.   "valueSelect": "string", //可选值列表
  12.   "valueType": 0 //可选值模式
  13. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

09、获取分类销售属性

请求方式：

  1. GET

请求地址：

  1. /product/attr/sale/list/{ catelogId}

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "attrId": 0, //属性id
  11.             "attrName": "string", //属性名
  12.             "attrType": 0, //属性类型，0-销售属性，1-基本属性
  13.             "catelogName": "手机/数码/手机", //所属分类名字
  14.             "groupName": "主体", //所属分组名字
  15.             "enable": 0, //是否启用
  16.             "icon": "string", //图标
  17.             "searchType": 0,//是否需要检索[0-不需要，1-需要]
  18.             "showDesc": 0,//是否展示在介绍上；0-否 1-是
  19.             "valueSelect": "string",//可选值列表[用逗号分隔]
  20.             "valueType": 0//值类型[0-为单个值，1-可以选择多个值]
  21.         }]
  22.     }
  23. }

10、获取属性分组的关联的所有属性

请求方式：

  1. GET

请求地址：

  1. /product/attrgroup/{ attrgroupId}/attr/relation

接口描述：

获取指定分组关联的所有属性

响应数据：

  1. { 
  2.   "msg": "success",
  3.   "code": 0,
  4.   "data": [
  5.     { 
  6.       "attrId": 4,
  7.       "attrName": "aad",
  8.       "searchType": 1,
  9.       "valueType": 1,
  10.       "icon": "qq",
  11.       "valueSelect": "v;q;w",
  12.       "attrType": 1,
  13.       "enable": 1,
  14.       "catelogId": 225,
  15.       "showDesc": 1
  16.     }
  17.   ]
  18. }

11、添加属性与分组关联关系

请求方式：

  1. POST

请求地址：

  1. /product/attrgroup/attr/relation

请求参数：

  1. [{ 
  2.   "attrGroupId": 0, //分组id
  3.   "attrId": 0, //属性id
  4. }]

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

12、删除属性与分组的关联关系

请求方式：

  1. POST

请求地址：

  1. /product/attrgroup/attr/relation/delete

请求参数：

  1. [{ "attrId":1,"attrGroupId":2}]

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

13、获取属性分组没有关联的其他属性

请求方式：

  1. GET

请求地址：

  1. /product/attrgroup/{ attrgroupId}/noattr/relation

接口描述：

获取属性分组里面还没有关联的本分类里面的其他基本属性，方便添加新的关联

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 3,
  6.         "pageSize": 10,
  7.         "totalPage": 1,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "attrId": 1,
  11.             "attrName": "aaa",
  12.             "searchType": 1,
  13.             "valueType": 1,
  14.             "icon": "aa",
  15.             "valueSelect": "aa;ddd;sss;aaa2",
  16.             "attrType": 1,
  17.             "enable": 1,
  18.             "catelogId": 225,
  19.             "showDesc": 1
  20.         }]
  21.     }
  22. }

14、获取分类关联的品牌

请求方式：

  1. GET

请求地址：

  1. /product/categorybrandrelation/brands/list

请求参数：

在这里插入图片描述

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "data": [{ 
  5.         "brandId": 0,
  6.         "brandName": "string",
  7.     }]
  8. }

15、获取品牌关联的分类

请求方式：

  1. GET

请求地址：

  1. /product/categorybrandrelation/catelog/list

请求参数：

在这里插入图片描述

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "data": [{ 
  5.         "catelogId": 0,
  6.         "catelogName": "string",
  7.     }]
  8. }

16、新增品牌与分类关联关系

请求方式：

  1. POST

请求地址：

  1. product/categorybrandrelation/save

请求参数：

  1. { "brandId":1,"catelogId":2}

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

17、获取分类下所有分组&关联属性

请求方式：

  1. GET

请求地址：

  1. /product/attrgroup/{ catelogId}/withattr

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "data": [{ 
  5.         "attrGroupId": 1,
  6.         "attrGroupName": "主体",
  7.         "sort": 0,
  8.         "descript": "主体",
  9.         "icon": "dd",
  10.         "catelogId": 225,
  11.         "attrs": [{ 
  12.             "attrId": 7,
  13.             "attrName": "入网型号",
  14.             "searchType": 1,
  15.             "valueType": 0,
  16.             "icon": "xxx",
  17.             "valueSelect": "aaa;bb",
  18.             "attrType": 1,
  19.             "enable": 1,
  20.             "catelogId": 225,
  21.             "showDesc": 1,
  22.             "attrGroupId": null
  23.             }, { 
  24.             "attrId": 8,
  25.             "attrName": "上市年份",
  26.             "searchType": 0,
  27.             "valueType": 0,
  28.             "icon": "xxx",
  29.             "valueSelect": "2018;2019",
  30.             "attrType": 1,
  31.             "enable": 1,
  32.             "catelogId": 225,
  33.             "showDesc": 0,
  34.             "attrGroupId": null
  35.             }]
  36.         },
  37.         { 
  38.         "attrGroupId": 2,
  39.         "attrGroupName": "基本信息",
  40.         "sort": 0,
  41.         "descript": "基本信息",
  42.         "icon": "xx",
  43.         "catelogId": 225,
  44.         "attrs": [{ 
  45.             "attrId": 11,
  46.             "attrName": "机身颜色",
  47.             "searchType": 0,
  48.             "valueType": 0,
  49.             "icon": "xxx",
  50.             "valueSelect": "黑色;白色",
  51.             "attrType": 1,
  52.             "enable": 1,
  53.             "catelogId": 225,
  54.             "showDesc": 1,
  55.             "attrGroupId": null
  56.         }]
  57.     }]
  58. }

18、spu检索

请求方式：

  1. GET

请求地址：

  1. /product/spuinfo/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为',//检索关键字
  7.    catelogId: 6,//三级分类id
  8.    brandId: 1,//品牌id 
  9.    status: 0,//商品状态
  10. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  11.             "brandId": 0, //品牌id
  12.             "brandName": "品牌名字",
  13.             "catalogId": 0, //分类id
  14.             "catalogName": "分类名字",
  15.             "createTime": "2019-11-13T16:07:32.877Z", //创建时间
  16.             "id": 0, //商品id
  17.             "publishStatus": 0, //发布状态
  18.             "spuDescription": "string", //商品描述
  19.             "spuName": "string", //商品名字
  20.             "updateTime": "2019-11-13T16:07:32.877Z", //更新时间
  21.             "weight": 0 //重量
  23.         }]
  24.     }
  25. }

19、新增商品

请求方式：

  1. POST

请求地址：

  1. /product/spuinfo/save

请求参数：

  1. { 
  2.     "spuName": "Apple XR",
  3.     "spuDescription": "Apple XR",
  4.     "catalogId": 225,
  5.     "brandId": 12,
  6.     "weight": 0.048,
  7.     "publishStatus": 0,
  8.     "decript": ["https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-22//66d30b3f-e02f-48b1-8574-e18fdf454a32_f205d9c99a2b4b01.jpg"],
  9.     "images": ["https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-22//dcfcaec3-06d8-459b-8759-dbefc247845e_5b5e74d0978360a1.jpg", "https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-22//5b15e90a-a161-44ff-8e1c-9e2e09929803_749d8efdff062fb0.jpg"],
  10.     "bounds": { 
  11.         "buyBounds": 500,
  12.         "growBounds": 6000
  13.     },
  14.     "baseAttrs": [{ 
  15.         "attrId": 7,
  16.         "attrValues": "aaa;bb",
  17.         "showDesc": 1
  18.     }, { 
  19.         "attrId": 8,
  20.         "attrValues": "2019",
  21.         "showDesc": 0
  22.     }],
  23.     "skus": [{ 
  24.         "attr": [{ 
  25.             "attrId": 9,
  26.             "attrName": "颜色",
  27.             "attrValue": "黑色"
  28.         }, { 
  29.             "attrId": 10,
  30.             "attrName": "内存",
  31.             "attrValue": "6GB"
  32.         }],
  33.         "skuName": "Apple XR 黑色 6GB",
  34.         "price": "1999",
  35.         "skuTitle": "Apple XR 黑色 6GB",
  36.         "skuSubtitle": "Apple XR 黑色 6GB",
  37.         "images": [{ 
  38.             "imgUrl": "https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-22//dcfcaec3-06d8-459b-8759-dbefc247845e_5b5e74d0978360a1.jpg",
  39.             "defaultImg": 1
  40.             }, { 
  41.             "imgUrl": "https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-22//5b15e90a-a161-44ff-8e1c-9e2e09929803_749d8efdff062fb0.jpg",
  42.             "defaultImg": 0
  43.         }],
  44.         "descar": ["黑色", "6GB"],
  45.         "fullCount": 5,
  46.         "discount": 0.98,
  47.         "countStatus": 1,
  48.         "fullPrice": 1000,
  49.         "reducePrice": 10,
  50.         "priceStatus": 0,
  51.         "memberPrice": [{ 
  52.             "id": 1,
  53.             "name": "aaa",
  54.             "price": 1998.99
  55.         }]
  56.         }, { 
  57.         "attr": [{ 
  58.             "attrId": 9,
  59.             "attrName": "颜色",
  60.             "attrValue": "黑色"
  61.         }, { 
  62.             "attrId": 10,
  63.             "attrName": "内存",
  64.             "attrValue": "12GB"
  65.         }],
  66.         "skuName": "Apple XR 黑色 12GB",
  67.         "price": "2999",
  68.         "skuTitle": "Apple XR 黑色 12GB",
  69.         "skuSubtitle": "Apple XR 黑色 6GB",
  70.         "images": [{ 
  71.             "imgUrl": "",
  72.             "defaultImg": 0
  73.         }, { 
  74.             "imgUrl": "",
  75.             "defaultImg": 0
  76.         }],
  77.         "descar": ["黑色", "12GB"],
  78.         "fullCount": 0,
  79.         "discount": 0,
  80.         "countStatus": 0,
  81.         "fullPrice": 0,
  82.         "reducePrice": 0,
  83.         "priceStatus": 0,
  84.         "memberPrice": [{ 
  85.             "id": 1,
  86.             "name": "aaa",
  87.             "price": 1998.99
  88.         }]
  89.     }, { 
  90.         "attr": [{ 
  91.             "attrId": 9,
  92.             "attrName": "颜色",
  93.             "attrValue": "白色"
  94.         }, { 
  95.             "attrId": 10,
  96.             "attrName": "内存",
  97.             "attrValue": "6GB"
  98.         }],
  99.         "skuName": "Apple XR 白色 6GB",
  100.         "price": "1998",
  101.         "skuTitle": "Apple XR 白色 6GB",
  102.         "skuSubtitle": "Apple XR 黑色 6GB",
  103.         "images": [{ 
  104.             "imgUrl": "",
  105.             "defaultImg": 0
  106.         }, { 
  107.             "imgUrl": "",
  108.             "defaultImg": 0
  109.         }],
  110.         "descar": ["白色", "6GB"],
  111.         "fullCount": 0,
  112.         "discount": 0,
  113.         "countStatus": 0,
  114.         "fullPrice": 0,
  115.         "reducePrice": 0,
  116.         "priceStatus": 0,
  117.         "memberPrice": [{ 
  118.             "id": 1,
  119.             "name": "aaa",
  120.             "price": 1998.99
  121.         }]
  122.     }, { 
  123.         "attr": [{ 
  124.             "attrId": 9,
  125.             "attrName": "颜色",
  126.             "attrValue": "白色"
  127.         }, { 
  128.             "attrId": 10,
  129.             "attrName": "内存",
  130.             "attrValue": "12GB"
  131.         }],
  132.         "skuName": "Apple XR 白色 12GB",
  133.         "price": "2998",
  134.         "skuTitle": "Apple XR 白色 12GB",
  135.         "skuSubtitle": "Apple XR 黑色 6GB",
  136.         "images": [{ 
  137.             "imgUrl": "",
  138.             "defaultImg": 0
  139.         }, { 
  140.             "imgUrl": "",
  141.             "defaultImg": 0
  142.         }],
  143.         "descar": ["白色", "12GB"],
  144.         "fullCount": 0,
  145.         "discount": 0,
  146.         "countStatus": 0,
  147.         "fullPrice": 0,
  148.         "reducePrice": 0,
  149.         "priceStatus": 0,
  150.         "memberPrice": [{ 
  151.             "id": 1,
  152.             "name": "aaa",
  153.             "price": 1998.99
  154.         }]
  155.     }]
  156. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

20、商品上架

请求方式：

  1. POST

请求地址：

  1. /product/spuinfo/{ spuId}/up

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

21、sku检索

请求方式：

  1. GET

请求地址：

  1. /product/skuinfo/list

请求参数：

  1. { 
  2.     page: 1,//当前页码
  3.     limit: 10,//每页记录数
  4.     sidx: 'id',//排序字段
  5.     order: 'asc/desc',//排序方式
  6.     key: '华为',//检索关键字
  7.     catelogId: 0,
  8.     brandId: 0,
  9.     min: 0,
  10.     max: 0
  11. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 26,
  6.         "pageSize": 10,
  7.         "totalPage": 3,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "skuId": 1,
  11.             "spuId": 11,
  12.             "skuName": "华为 HUAWEI Mate 30 Pro 星河银 8GB+256GB",
  13.             "skuDesc": null,
  14.             "catalogId": 225,
  15.             "brandId": 9,
  16.             "skuDefaultImg": "https://gulimall-hello.oss-cn-beijing.aliyuncs.com/2019-11-26/60e65a44-f943-4ed5-87c8-8cf90f403018_d511faab82abb34b.jpg",
  17.             "skuTitle": "华为 HUAWEI Mate 30 Pro 星河银 8GB+256GB麒麟990旗舰芯片OLED环幕屏双4000万徕卡电影四摄4G全网通手机",
  18.             "skuSubtitle": "【现货抢购！享白条12期免息！】麒麟990，OLED环幕屏双4000万徕卡电影四摄；Mate30系列享12期免息》",
  19.             "price": 6299.0000,
  20.             "saleCount": 0
  21.         }]
  22.     }
  23. }

22、获取spu规格

请求方式：

  1. GET

请求地址：

  1. /product/attr/base/listforspu/{ spuId}

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "data": [{ 
  5.         "id": 43,
  6.         "spuId": 11,
  7.         "attrId": 7,
  8.         "attrName": "入网型号",
  9.         "attrValue": "LIO-AL00",
  10.         "attrSort": null,
  11.         "quickShow": 1
  12.     }]
  13. }

23、修改商品规格

请求方式：

  1. POST

请求地址：

  1. /product/attr/update/{ spuId}

请求参数：

  1. [{ 
  2.     "attrId": 7,
  3.     "attrName": "入网型号",
  4.     "attrValue": "LIO-AL00",
  5.     "quickShow": 1
  6. }, { 
  7.     "attrId": 14,
  8.     "attrName": "机身材质工艺",
  9.     "attrValue": "玻璃",
  10.     "quickShow": 0
  11. }, { 
  12.     "attrId": 16,
  13.     "attrName": "CPU型号",
  14.     "attrValue": "HUAWEI Kirin 980",
  15.     "quickShow": 1
  16. }]

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

订单系统

无

用户系统

01、获取所有会员等级

请求方式：

  1. POST

请求地址：

  1. /member/memberlevel/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "id": 1,
  11.             "name": "aaa",
  12.             "growthPoint": null,
  13.             "defaultStatus": null,
  14.             "freeFreightPoint": null,
  15.             "commentGrowthPoint": null,
  16.             "priviledgeFreeFreight": null,
  17.             "priviledgeMemberPrice": null,
  18.             "priviledgeBirthday": null,
  19.             "note": null
  20.         }]
  21.     }
  22. }

库存系统

01、仓库列表

请求方式：

  1. GET

请求地址：

  1. /ware/wareinfo/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "id": 2,
  11.             "name": "aa",
  12.             "address": "bbb",
  13.             "areacode": "124"
  14.         }]
  15.     }
  16. }

02、查询商品库存

请求方式：

  1. GET

请求地址：

  1. /ware/waresku/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    wareId: 123,//仓库id
  7.    skuId: 123//商品id
  8. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "id": 1,
  11.             "skuId": 1,
  12.             "wareId": 1,
  13.             "stock": 1,
  14.             "skuName": "dd",
  15.             "stockLocked": 1
  16.         }]
  17.     }
  18. }

03、查询采购需求

请求方式：

  1. GET

请求地址：

  1. /ware/purchasedetail/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为',//检索关键字
  7.    status: 0,//状态 
  8.    wareId: 1,//仓库id
  9. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "id": 2,
  11.             "purchaseId": 1,
  12.             "skuId": 1,
  13.             "skuNum": 2,
  14.             "skuPrice": 22.0000,
  15.             "wareId": 1,
  16.             "status": 1
  17.         }]
  18.     }
  19. }

04、合并采购需求

请求方式：

  1. POST

请求地址：

  1. /ware/purchase/merge

请求参数：

  1. { 
  2.   purchaseId: 1, //整单id
  3.   items:[1,2,3,4] //合并项集合
  4. }

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

05、查询未领取的采购单

请求方式：

  1. GET

请求地址：

  1. /ware/purchase/unreceive/list

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0,
  4.     "page": { 
  5.         "totalCount": 0,
  6.         "pageSize": 10,
  7.         "totalPage": 0,
  8.         "currPage": 1,
  9.         "list": [{ 
  10.             "id": 1,
  11.             "assigneeId": 1,
  12.             "assigneeName": "aa",
  13.             "phone": "123",
  14.             "priority": 1,
  15.             "status": 1,
  16.             "wareId": 1,
  17.             "amount": 22.0000,
  18.             "createTime": "2019-12-12",
  19.             "updateTime": "2019-12-12"
  20.         }]
  21.     }
  22. }

06、领取采购单

请求方式：

  1. POST

请求地址：

  1. /ware/purchase/received

请求参数：

  1. [1,2,3,4]//采购单id

分页数据

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

07、完成采购

请求方式：

  1. POST

请求地址：

  1. /ware/purchase/done

请求参数：

  1. { 
  2.    id: 123,//采购单id
  3.    items: [{ itemId:1,status:4,reason:""}]//完成/失败的需求详情
  4. }

响应数据：

  1. { 
  2.     "msg": "success",
  3.     "code": 0
  4. }

优惠系统

01、获取优惠券

请求方式：

  1. GET

请求地址：

  1. /coupon/coupon/list

请求参数：

  1. { 
  2.    page: 1,//当前页码
  3.    limit: 10,//每页记录数
  4.    sidx: 'id',//排序字段
  5.    order: 'asc/desc',//排序方式
  6.    key: '华为'//检索关键字
  7. }

第三方服务

01、获取对象存储服务端签名

请求方式：

  1. GET

请求地址：

  1. /thirdparty/oss/policy

响应参数：

在这里插入图片描述
data：

在这里插入图片描述

二、商城系统接口

首页

无

商品

01、商品检索

请求方式：

  1. GET

请求地址：

  1. /api/search

请求参数：

在这里插入图片描述

请求示例：

  1. api/search?keyword=小米&brandId=1&catalogId=1&sort=hotscore_desc&price=0_400&stock=1&attrs=1_3G:4G&attrs=2_骁龙855:骁龙845

响应数据：

  1. { 
  2.     "code": 0,
  3.     "msg": "success",
  4.     "data": { 
  5.         "skus": [{ 
  6.             "skuId": 1,
  7.             "spuId": 5,
  8.             "skuPrice": 999.88,
  9.             "skuTitle": "华为",
  10.             "skuImg": "xxxx.jpg",
  11.             "otherImgs": [""]
  12.         }],
  13.         "brands": [{ 
  14.             "brandId": 5,
  15.             "brandName": "华为",
  16.             "img": "xxxxx.jpg"
  17.         }],
  18.         "catalogs": [{ 
  19.             "catId": 5,
  20.             "catName": "手机"
  21.         }],
  22.         "attrs": [{ 
  23.             "attrId": 11,
  24.             "attrName": "屏幕",
  25.             "attrValues": ["全高清", "1080p"]
  26.         }]
  27.     }
  28. }

个人中心

无

购物车

无

订单支付

无

发表评论

表情：
评论列表 （有 0 条评论，428人围观）

还没有评论，来说两句吧...

相关阅读