【微信小程序】电商移动前端API文档

心已赠人 2024-04-01 08:20 46阅读 0赞

![在这里插入图片描述][52e202be94f04b8caa425bfea3a1f324.jpeg_pic_center]

#### 文章目录 ####

*   *  一、文档更新说明
     *   *  1、返回值调整
         *  2、分类页图片
         *  3、订单支付接口
     *  二、路径说明
     *  三、电商登录实现方式
     *  四、API详情
     *   *  1、全局权限访问
         *   *  （1）主页API
             *   *  获取首页轮播图数据
                 *  获取首页分类选项数据
                 *  获取首页楼层数据
             *  （2）商品API
             *   *  商品列表搜索
                 *  搜索建议查询
                 *  商品详情
             *  （3）分类API
             *   *  获取分类数据
             *  （4）微信用户登录 API
             *   *  微信登录换取 Token
         *  2、登录后访问
         *   *  （1）订单API
             *   *  创建订单
                 *  订单预支付
                 *  订单支付状态查询
                 *  订单查询

--------------------

request域名：小程序只支持 https 协议，并且要求是已备案的域名。

https://www.zhengzhicheng.cn
    备用：
    https://autumnfish.cn/wx
    https://www.uinav.com

### 一、文档更新说明 ###

> 更新日期 2019-04-01

#### 1、返回值调整 ####

新版接口调整：  res.data.message
    
    旧版接口废弃：  res.data.data

#### 2、分类页图片 ####

新版接口调整：  cat_icon 属性直接返回完整图片 url 地址
    
    旧版接口废弃：  cat_icon 返回相对路径，需要手动拼接路径

#### 3、订单支付接口 ####

新版接口调整：  支付对象数据为 res.data.message.pay
    
    旧版接口废弃：  支付对象数据为 res.data.data.wxorder

### 二、路径说明 ###

*  根路径说明

https://请求域名/api/public/v1

*  路径权限说明
    
     *  路径所有权限都可以访问
    
        https://请求域名/api/public/v1
    
     *  只有登录用户才可以访问路径
    
        https://请求域名/api/public/v1/my

### 三、电商登录实现方式 ###

*  采用 jwt 方式进行
 *  实现流程
    
    1.  请求登录
    2.  获取token
    3.  访问有权限的路径必须把 token 放置到 http 头中
    
        "Authorization" : token
    
    1.  token 不过期，长期有效。

### 四、API详情 ###

#### 1、全局权限访问 ####

*  访问根路径

https://请求域名/api/public/v1

##### （1）主页API #####

###### 获取首页轮播图数据 ######

*  请求路径：https://请求域名/api/public/v1/home/swiperdata
 *  请求方法：GET
 *  请求参数

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>image_src</td> 
   <td>图片路径</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>open_type</td> 
   <td>导航链接类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>navigator_url</td> 
   <td>导航链接路径</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据参考

{
        "message": [
            {
                "image_src": "https://www.zhengzhicheng.cn/pyg/banner1.png",
                "open_type": "navigate",
                "goods_id": 129,
                "navigator_url": "/pages/goods_detail/main?goods_id=129"
            },
            {
                "image_src": "https://www.zhengzhicheng.cn/pyg/banner2.png",
                "open_type": "navigate",
                "goods_id": 395,
                "navigator_url": "/pages/goods_detail/main?goods_id=395"
            },
            {
                "image_src": "https://www.zhengzhicheng.cn/pyg/banner3.png",
                "open_type": "navigate",
                "goods_id": 38,
                "navigator_url": "/pages/goods_detail/main?goods_id=38"
            }
        ],
        "meta": { "msg": "获取成功", "status": 200 }
    }

###### 获取首页分类选项数据 ######

*  请求路径：https://请求域名/api/public/v1/home/catitems
 *  请求方法：GET
 *  请求参数

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>name</td> 
   <td>名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>image_src</td> 
   <td>图片路径</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>open_type</td> 
   <td>导航链接类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>navigator_url</td> 
   <td>导航链接路径</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
        "message": [
            {
        
                "name": "分类",
                "image_src": "https://www.zhengzhicheng.cn/pyg/icon_index_nav_4@2x.png",
                "open_type": "switchTab",
                "navigator_url": "/pages/category/main"
            },
            {
        
                "name": "秒杀拍",
                "image_src": "https://www.zhengzhicheng.cn/pyg/icon_index_nav_3@2x.png"
            },
            {
        
                "name": "超市购",
                "image_src": "https://www.zhengzhicheng.cn/pyg/icon_index_nav_2@2x.png"
            },
            {
        
                "name": "母婴品",
                "image_src": "https://www.zhengzhicheng.cn/pyg/icon_index_nav_1@2x.png"
            }
        ],
        "meta": {
         "msg": "获取成功", "status": 200 }
    }

###### 获取首页楼层数据 ######

*  请求路径：https://请求域名/api/public/v1/home/floordata
 *  请求方法：GET
 *  请求参数

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>floor_title</td> 
   <td>楼层标题</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>product_list</td> 
   <td>楼层内容列表</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>name</td> 
   <td>名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>image_src</td> 
   <td>图片路径</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>image_width</td> 
   <td>商品图片宽度</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>open_type</td> 
   <td>导航链接类型</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>navigator_url</td> 
   <td>导航链接路径</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
        "message": [
            {
        
                "floor_title": {
        
                    "name": "时尚女装",
                    "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_title.png"
                },
                "product_list": [
                    {
        
                        "name": "优质服饰",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_1@2x.png",
                        "image_width": "232",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=服饰"
                    },
                    {
        
                        "name": "春季热门",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_2@2x.png",
                        "image_width": "233",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=热"
                    },
                    {
        
                        "name": "爆款清仓",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_3@2x.png",
                        "image_width": "233",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=爆款"
                    },
                    {
        
                        "name": "倒春寒",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_4@2x.png",
                        "image_width": "233",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=春季"
                    },
                    {
        
                        "name": "怦然心动",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor01_5@2x.png",
                        "image_width": "233",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=心动"
                    }
                ]
            },
            {
        
                "floor_title": {
        
                    "name": "户外活动",
                    "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_title.png"
                },
                "product_list": [
                    {
        
                        "name": "勇往直前",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_1@2x.png",
                        "image_width": "232",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=户外"
                    },
                    {
        
                        "name": "户外登山包",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_2@2x.png",
                        "image_width": "273",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=登山包"
                    },
                    {
        
                        "name": "超强手套",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_3@2x.png",
                        "image_width": "193",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=手套"
                    },
                    {
        
                        "name": "户外运动鞋",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_4@2x.png",
                        "image_width": "193",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=运动鞋"
                    },
                    {
        
                        "name": "冲锋衣系列",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor02_5@2x.png",
                        "image_width": "273",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=冲锋衣"
                    }
                ]
            },
            {
        
                "floor_title": {
        
                    "name": "箱包配饰",
                    "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_title.png"
                },
                "product_list": [
                    {
        
                        "name": "清新气质",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_1@2x.png",
                        "image_width": "232",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=饰品"
                    },
                    {
        
                        "name": "复古胸针",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_2@2x.png",
                        "image_width": "263",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=胸针"
                    },
                    {
        
                        "name": "韩版手链",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_3@2x.png",
                        "image_width": "203",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=手链"
                    },
                    {
        
                        "name": "水晶项链",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_4@2x.png",
                        "image_width": "193",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=水晶项链"
                    },
                    {
        
                        "name": "情侣表",
                        "image_src": "https://www.zhengzhicheng.cn/pyg/pic_floor03_5@2x.png",
                        "image_width": "273",
                        "open_type": "navigate",
                        "navigator_url": "/pages/goods_list?query=情侣表"
                    }
                ]
            }
        ],
        "meta": {
         "msg": "获取成功", "status": 200 }
    }

##### （2）商品API #####

###### 商品列表搜索 ######

*  请求路径：https://请求域名/api/public/v1/goods/search
 *  请求方法：GET
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>query</td> 
   <td>查询关键词</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cid</td> 
   <td>分类ID</td> 
   <td>可选</td> 
  </tr> 
  <tr> 
   <td>pagenum</td> 
   <td>页数索引</td> 
   <td>可选默认第一页</td> 
  </tr> 
  <tr> 
   <td>pagesize</td> 
   <td>每页长度</td> 
   <td>可选默认20条</td> 
  </tr> 
 </tbody> 
</table>

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>total</td> 
   <td>总共记录</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>pagenum</td> 
   <td>当前页数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_id</td> 
   <td>商品ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_id</td> 
   <td>分类ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_name</td> 
   <td>商品名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_price</td> 
   <td>商品价格</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_number</td> 
   <td>商品数量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_weight</td> 
   <td>商品重量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_big_logo</td> 
   <td>商品大图标</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_small_logo</td> 
   <td>商品小图标</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>add_time</td> 
   <td>商品添加时间</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>upd_time</td> 
   <td>商品更新时间</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>hot_mumber</td> 
   <td>热门商品数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_one_id</td> 
   <td>所属一级分类</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_two_id</td> 
   <td>所属二级分类</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_three_id</td> 
   <td>所属三级分类</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        "message": {
            "total": 2058,
            "pagenum": "1",
            "goods": [
                {
                    "goods_id": 57332,
                    "cat_id": 998,
                    "goods_name": "400毫升 海鲜食品冷藏冰包 注水冰袋医用冰袋户外冷藏保鲜熟食冷藏反复使用（10个装）",
                    "goods_price": 14,
                    "goods_number": 100,
                    "goods_weight": 100,
                    "goods_big_logo": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_800x800.jpg",
                    "goods_small_logo": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_400x400.jpg",
                    "add_time": 1516662792,
                    "upd_time": 1516662792,
                    "hot_mumber": 0,
                    "is_promote": false,
                    "cat_one_id": 962,
                    "cat_two_id": 981,
                    "cat_three_id": 998
                },
                {
                    "goods_id": 57194,
                    "cat_id": 992,
                    "goods_name": "亿力洗车工具汽车美容用品海绵刷不伤车漆擦车海棉清洁海绵",
                    "goods_price": 29,
                    "goods_number": 100,
                    "goods_weight": 100,
                    "goods_big_logo": "",
                    "goods_small_logo": "",
                    "add_time": 1516662312,
                    "upd_time": 1516662312,
                    "hot_mumber": 0,
                    "is_promote": false,
                    "cat_one_id": 962,
                    "cat_two_id": 980,
                    "cat_three_id": 992
                }
            ]
        },
        "meta": {
            "msg": "获取成功",
            "status": 200
        }
    }

###### 搜索建议查询 ######

*  请求路径：https://请求域名/api/public/v1/goods/qsearch
 *  请求方法：GET
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>query</td> 
   <td>查询内容</td> 
   <td>如： goods/qsearch?query=小米</td> 
  </tr> 
 </tbody> 
</table>

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>goods_id</td> 
   <td>商品ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_name</td> 
   <td>商品名称</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        "message": [
            {
                "goods_id": 57332,
                "goods_name": "400毫升 海鲜食品冷藏冰包 注水冰袋医用冰袋户外冷藏保鲜熟食冷藏反复使用（10个装）"
            },
            {
                "goods_id": 57194,
                "goods_name": "亿力洗车工具汽车美容用品海绵刷不伤车漆擦车海棉清洁海绵"
            }
        ],
        "meta": {
            "msg": "获取成功",
            "status": 200
        }
    }

###### 商品详情 ######

*  请求路径：https://请求域名/api/public/v1/goods/detail
 *  请求方法：GET
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>goods_id</td> 
   <td>商品ID</td> 
   <td>必要</td> 
  </tr> 
 </tbody> 
</table>

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>goods_id</td> 
   <td>商品ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_id</td> 
   <td>分类ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_name</td> 
   <td>商品名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_price</td> 
   <td>商品价格</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_number</td> 
   <td>商品数量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_weight</td> 
   <td>商品重量</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_big_logo</td> 
   <td>商品大图标</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_small_logo</td> 
   <td>商品小图标</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>add_time</td> 
   <td>商品添加时间</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>upd_time</td> 
   <td>商品更新时间</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>hot_mumber</td> 
   <td>热门商品数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_one_id</td> 
   <td>所属一级分类</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_two_id</td> 
   <td>所属二级分类</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_three_id</td> 
   <td>所属三级分类</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>goods_introduce</td> 
   <td>商品介绍HTML富文本</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>pics</td> 
   <td>商品图片列表</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>attrs</td> 
   <td>商品属性列表</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
        "message": {
        
            "goods_id": 57332,
            "cat_id": 998,
            "goods_name": "400毫升 海鲜食品冷藏冰包 注水冰袋医用冰袋户外冷藏保鲜熟食冷藏反复使用（10个装）",
            "goods_price": 14,
            "goods_number": 100,
            "goods_weight": 100,
            "goods_introduce": "<div class=\"lazyimg\">\n<p><img data-src=\"//image.suning.cn/uimg/sop/commodity/167890268714163515505319_x.jpg?from=mobile&format=80q.webp\" alt=\"\" usemap=\"#Map\" border=\"0\" src=\"//image.suning.cn/uimg/sop/commodity/167890268714163515505319_x.jpg?from=mobile&format=80q.webp\" width=\"100%\" height=\"auto\"> </p>\n<p></p><p><img picsize=\"706KB\" data-src=\"//image.suning.cn/uimg/sop/phonecomm/157271695856956094412300_640x.jpg?from=mobile&format=80q.webp\" alt=\"\" src=\"//image.suning.cn/uimg/sop/phonecomm/157271695856956094412300_640x.jpg?from=mobile&format=80q.webp\" width=\"100%\" height=\"auto\"></p><p><img picsize=\"610KB\" data-src=\"//image.suning.cn/uimg/sop/phonecomm/192892939814201549766135_640x.jpg?from=mobile&format=80q.webp\" alt=\"\" src=\"//image.suning.cn/uimg/sop/phonecomm/192892939814201549766135_640x.jpg?from=mobile&format=80q.webp\" width=\"100%\" height=\"auto\"></p></div>",
            "goods_big_logo": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_800x800.jpg",
            "goods_small_logo": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_400x400.jpg",
            "goods_state": 2,
            "is_del": "0",
            "add_time": 1516662792,
            "upd_time": 1516662792,
            "delete_time": null,
            "hot_mumber": 0,
            "is_promote": false,
            "cat_one_id": 962,
            "cat_two_id": 981,
            "cat_three_id": 998,
            "goods_cat": "962,981,998",
            "pics": [
                {
        
                    "pics_id": 234751,
                    "goods_id": 57332,
                    "pics_big": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_800x800.jpg",
                    "pics_mid": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_400x400.jpg",
                    "pics_sma": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_200x200.jpg",
                    "pics_big_url": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_800x800.jpg",
                    "pics_mid_url": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_400x400.jpg",
                    "pics_sma_url": "http://image4.suning.cn/uimg/b2c/newcatentries/0070083251-000000000168369396_1_200x200.jpg"
                }
            ],
            "attrs": [
                {
        
                    "goods_id": 57332,
                    "attr_id": 8519,
                    "attr_value": "400",
                    "add_price": 0,
                    "attr_name": "主体-型号",
                    "attr_sel": "only",
                    "attr_write": "manual",
                    "attr_vals": "Q6"
                }
            ]
        },
        "meta": {
        
            "msg": "获取成功",
            "status": 200
        }
    }

##### （3）分类API #####

###### 获取分类数据 ######

*  请求路径：https://请求域名/api/public/v1/categories
 *  请求方法：GET
 *  请求参数

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>cat_id</td> 
   <td>分类ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_name</td> 
   <td>分类名称</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_level</td> 
   <td>分类级别</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>cat_icon</td> 
   <td>分类图标</td> 
   <td>只有3级别分类采用图标</td> 
  </tr> 
  <tr> 
   <td>children</td> 
   <td>子分类列表</td> 
   <td>对象数组</td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
        "message": [
            {
        
                "cat_id": 1,
                "cat_name": "大家电",
                "cat_pid": 0,
                "cat_level": 0,
                "cat_deleted": false,
                "cat_icon": "",
                "children": [
                    {
        
                        "cat_id": 3,
                        "cat_name": "电视",
                        "cat_pid": 1,
                        "cat_level": 1,
                        "cat_deleted": false,
                        "cat_icon": "",
                        "children": [
                        {
        
                            "cat_id": 5,
                            "cat_name": "曲面电视",
                            "cat_pid": 3,
                            "cat_level": 2,
                            "cat_deleted": false,
                            "cat_icon": "full/2fb113b32f7a2b161f5ee4096c319afedc3fd5a1.jpg"
                        }]
                    }
                ]
            }
        ],
        "meta": {
        
            "msg": "获取成功",
            "status": 200
        }
    }

##### （4）微信用户登录 API #####

###### 微信登录换取 Token ######

*  请求路径：https://请求域名/api/public/v1/users/wxlogin
 *  请求方法：POST
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>code</td> 
   <td>用户登录凭证</td> 
   <td>必要，可通过 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/api-login.html#wxloginobject" rel="nofollow">wx.login()</a> 获取</td> 
  </tr> 
  <tr> 
   <td>encryptedData</td> 
   <td>完整用户信息密文</td> 
   <td>必要，可通过 getUserInfo 获取</td> 
  </tr> 
  <tr> 
   <td>iv</td> 
   <td>加密算法的初始向量</td> 
   <td>必要，可通过 getUserInfo 获取</td> 
  </tr> 
  <tr> 
   <td>rawData</td> 
   <td>用户信息原始数据字符串</td> 
   <td>必要，可通过 getUserInfo 获取，JSON.stringify() 转字符串</td> 
  </tr> 
  <tr> 
   <td>signature</td> 
   <td>使用 sha1得到字符串</td> 
   <td>必要，可通过 getUserInfo 获取</td> 
  </tr> 
 </tbody> 
</table>

*  请求数据参考

{
        
      "code": "013pZWCt0GniKb1ftkBt0AxfDt0pZWCf",
      "encryptedData": "FGMaNbO4ytTFTUzK3wmtfHWoFeQJYkyMajQ5tVbQglwmnJ46SMi43Thq0OZjSSa5Msmnpdfx7yigYkdvUbsiQFyF9xMGEQLpUFcpNjnYoCQOl2Ka5zEeqpMY91ywYAsPISeu1rwvFCU2Ucenxf7gdcDPQ/jNJdORGb86DR+2gVJeg8TZiXWJ66enpynj35DiaE1jNWUSzpgbOvO40dZrWnHVwDEJN+upeSHRR/IW7t3cgtV63/GeZzNhFbUYqNHO6M1KHetwY1u8mFXuZoXwVV7DrEwEzY1btqcfW93q4ekn2uwAUeJM4U+3roBsIT5ZpEM8YtQZVsAwjaWHBe8id1H4lurEFC5/GwLnRONrIiR7KDF7MPxnMO9flWFQEfay5dt9rBELzk1Efjf2H6UnzYfh+o4MbPxtc0cUiHEnNCVcXjDtulXSRUy7RZQPmjF/tYBHHrXEFubxnK4oRBZz/A==",
      "iv": "y/ESFBaesbEzIbB1th5Knw==",
      "rawData":
        "{\"nickName\":\"优购\",\"gender\":0,\"language\":\"zh_CN\",\"city\":\"\",\"province\":\"\",\"country\":\"\",\"avatarUrl\":\"https://wx.qlogo.cn/mmopen/vi_32/icWlxE4rARHaIlib1PRmBtRa2tQicUSEHYu8UIGZ0LLic9C0PticibED6brRFCuQYeLGtwTcBYFgMtcF11N31pVhMF8g/132\"}",
      "signature": "d06cd3a54e89e6014e43694844706eaccad109bb"
    }

*  响应参数参考

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>token</td> 
   <td>身份验证标志</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>user_id</td> 
   <td>用户ID</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
      "message": {
        
        "user_id": 12,
        "user_email_code": null,
        "is_active": null,
        "user_sex": "男",
        "user_qq": "",
        "user_tel": "",
        "user_xueli": "本科",
        "user_hobby": "",
        "user_introduce": null,
        "create_time": 1525402223,
        "update_time": 1525402223,
        "token":
          "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1aWQiOjEyLCJpYXQiOjE1MjU0MDIyMjMsImV4cCI6MTUyNTQ4ODYyM30.g-4GtEQNPwT_Xs0Pq7Lrco_9DfHQQsBiOKZerkO-O-o"
      },
      "meta": {
         "msg": "登录成功", "status": 200 }
    }

#### 2、登录后访问 ####

*  访问根路径

https://请求域名/api/public/v1/my

*  访问此系列请求必须在头信息中添加token

"Authorization" : token

##### （1）订单API #####

###### 创建订单 ######

*  请求路径：https://请求域名/api/public/v1/my/orders/create
 *  请求方法：POST
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_price</td> 
   <td>订单价格</td> 
   <td>必要</td> 
  </tr> 
  <tr> 
   <td>consignee_addr</td> 
   <td>订单地址</td> 
   <td>必要</td> 
  </tr> 
  <tr> 
   <td>order_detail</td> 
   <td>订单详情</td> 
   <td>可选，字符串格式</td> 
  </tr> 
  <tr> 
   <td>goods</td> 
   <td>商品列表内部存放商品（goods_id，goods_number和goods_price）列表</td> 
   <td>必要</td> 
  </tr> 
 </tbody> 
</table>

*  请求数据参考

{
        
      "order_price": 0.1,
      "consignee_addr": "广州市天河区",
      "order_detail":
        "[{\"goods_id\":55578,\"goods_name\":\"初语2017秋装新款潮牌女装加绒宽松BF风慵懒卫衣女套头连帽上衣\",\"goods_price\":279,\"goods_small_logo\":\"http://image2.suning.cn/uimg/b2c/newcatentries/0070067836-000000000690453616_2_400x400.jpg\",\"counts\":1,\"selectStatus\":true}]",
      "goods": [
          {
         
              "goods_id": 5, 
              "goods_number": 11, 
              "goods_price": 15 
          },
          {
         
              "goods_id": 555, 
              "goods_number": 1, 
              "goods_price": 15 
          }
      ]
    }

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_id</td> 
   <td>订单唯一ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>user_id</td> 
   <td>用户ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_number</td> 
   <td>订单编号</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_price</td> 
   <td>订单总金额</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_pay</td> 
   <td>订单支付方式</td> 
   <td>支付方式 0未支付 1支付宝 2微信 3银行卡</td> 
  </tr> 
  <tr> 
   <td>consignee_addr</td> 
   <td>订单地址</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>pay_status</td> 
   <td>订单支付状态</td> 
   <td>订单状态： 0未付款、1已付款</td> 
  </tr> 
 </tbody> 
</table>

*  响应数据参考

{
        
      "message": {
        
        "order_id": 45,
        "user_id": 12,
        "order_number": "GD20180504000000000045",
        "order_price": 0.1,
        "order_pay": "0",
        "is_send": "否",
        "trade_no": "",
        "order_fapiao_title": "个人",
        "order_fapiao_company": "",
        "order_fapiao_content": "",
        "consignee_addr": "广州市天河区",
        "pay_status": "0",
        "create_time": 1525408071,
        "update_time": 1525408071,
        "order_detail":
          "[{\"goods_id\":55578,\"goods_name\":\"初语2017秋装新款潮牌女装加绒宽松BF风慵懒卫衣女套头连帽上衣\",\"goods_price\":279,\"goods_small_logo\":\"http://image2.suning.cn/uimg/b2c/newcatentries/0070067836-000000000690453616_2_400x400.jpg\",\"counts\":1,\"selectStatus\":true}]",
        "goods": [
          {
        
            "id": 64,
            "order_id": 45,
            "goods_id": 5,
            "goods_price": 15,
            "goods_number": 11,
            "goods_total_price": 15
          }
        ]
      },
      "meta": {
         "msg": "创建订单成功", "status": 200 }
    }

###### 订单预支付 ######

*  请求路径：https://请求域名/api/public/v1/my/orders/req\_unifiedorder
 *  请求方法：POST
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_number</td> 
   <td>订单编号</td> 
   <td>必要</td> 
  </tr> 
 </tbody> 
</table>

*  请求数据

{
         "order_number": "GD20180507000000000110" }

*  响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>pay</td> 
   <td>订单对象</td> 
   <td>可通过 <a href="https://developers.weixin.qq.com/miniprogram/dev/api/api-pay.html#wxrequestpaymentobject" rel="nofollow">wx.requestPayment(OBJECT)</a>，发起微信支付</td> 
  </tr> 
  <tr> 
   <td>timeStamp</td> 
   <td>时间戳</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>nonceStr</td> 
   <td>随机字符串</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>package</td> 
   <td>下单接口返回参数</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>signType</td> 
   <td>签名算法</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>paySign</td> 
   <td>签名</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_number</td> 
   <td>订单编号</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
      "message": {
        "pay": {
          "timeStamp": "1525681145",
          "nonceStr": "BkPggorBXZwPGXe3",
          "package": "prepay_id=wx071619042918087bb4c1d3d72999385683",
          "signType": "MD5",
          "paySign": "D1642DEEF1663C8012EDEB9297E1D516"
        },
        "order_number": "GD20180507000000000110"
      },
      "meta": { "msg": "预付订单生成成功", "status": 200 }
    }

###### 订单支付状态查询 ######

*  请求路径：https://请求域名/api/public/v1/my/orders/chkOrder
 *  请求方法：POST
 *  请求参数

*  请求数据

{
         "order_number": "GD20180507000000000050" }

*  响应参数

*  响应数据

// 支付成功
    {
        "message":"支付成功",
        "meta":{"msg":"验证成功","status":200}
    }
    
    // 支付失败
    { 
        "message": null,
        "meta": { "msg": "订单未支付", "status": 400 } 
    }

###### 订单查询 ######

*  请求路径：https://请求域名/api/public/v1/my/orders/all
 *  请求方法：GET
 *  请求参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>type</td> 
   <td>1</td> 
   <td>1 全部订单 2 代付款订单 3 已付款订单</td> 
  </tr> 
 </tbody> 
</table>

*  2响应参数

<table> 
 <thead> 
  <tr> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>order_id</td> 
   <td>订单唯一ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>user_id</td> 
   <td>用户ID</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_number</td> 
   <td>订单编号</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_price</td> 
   <td>订单价格</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>order_pay</td> 
   <td>订单支付方式</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>consignee_addr</td> 
   <td>订单地址</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>pay_status</td> 
   <td>订单支付状态</td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

*  响应数据

{
        
      "message": [
        {
        
          "order_id": 44,
          "user_id": 12,
          "order_number": "GD20180507000000000050",
          "order_price": 0.1,
          "order_pay": "0",
          "is_send": "否",
          "trade_no": "",
          "order_fapiao_title": "个人",
          "order_fapiao_company": "",
          "order_fapiao_content": "",
          "consignee_addr": "广州市天河区",
          "pay_status": "0",
          "create_time": 1525407814,
          "update_time": 1525407814,
          "order_detail":
            "[{\"goods_id\":55578,\"goods_name\":\"初语2017秋装新款潮牌女装加绒宽松BF风慵懒卫衣女套头连帽上衣\",\"goods_price\":279,\"goods_small_logo\":\"http://image2.suning.cn/uimg/b2c/newcatentries/0070067836-000000000690453616_2_400x400.jpg\",\"counts\":1,\"selectStatus\":true}]"
        }
      ],
      "meta": {
         "msg": "获取订单列表成功", "status": 200 }
    }

[52e202be94f04b8caa425bfea3a1f324.jpeg_pic_center]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/f4337f3860a84ea18245d10e315810ed.jpeg