【微信小程序】电商移动前端API文档_免费的商城小程序api文档，万分膜拜请求参数参数名参数说明备注无响应参数

请求参数

参数名	参数说明	备注
无

响应参数

参数名	参数说明	备注
name	名称
image_src	图片路径
open_type	导航链接类型
navigator_url	导航链接路径

响应数据

{
    "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
请求参数

参数名	参数说明	备注
无

响应参数

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

响应数据

{
    "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
请求参数

参数名	参数说明	备注
query	查询关键词
cid	分类ID	可选
pagenum	页数索引	可选默认第一页
pagesize	每页长度	可选默认20条

响应参数

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

响应数据

{
    "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
请求参数

参数名	参数说明	备注
query	查询内容	如： goods/qsearch?query=小米

响应参数

参数名	参数说明	备注
goods_id	商品ID
goods_name	商品名称

响应数据

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

商品详情

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

参数名	参数说明	备注
goods_id	商品ID	必要

响应参数

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

响应数据

{
    "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\"><!-- Save for Web Slices (20170730关联模板.psd) -->\n<p><img data-src=\"//image.suning.cn/uimg/sop/commodity/167890268714163515505319\_x.jpg?from=mobile&amp;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<!-- End Save for Web Slices --><p></p><p><img picsize=\"706KB\" data-src=\"//image.suning.cn/uimg/sop/phonecomm/157271695856956094412300\_640x.jpg?from=mobile&amp;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&amp;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
请求参数

参数名	参数说明	备注
无

响应参数

参数名	参数说明	备注
cat_id	分类ID
cat_name	分类名称
cat_level	分类级别
cat_icon	分类图标	只有3级别分类采用图标
children	子分类列表	对象数组

响应数据

{
    "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
请求参数

参数名	参数说明	备注
code	用户登录凭证	必要，可通过 wx.login() 获取
encryptedData	完整用户信息密文	必要，可通过 getUserInfo 获取
iv	加密算法的初始向量	必要，可通过 getUserInfo 获取
rawData	用户信息原始数据字符串	必要，可通过 getUserInfo 获取，JSON.stringify() 转字符串
signature	使用 sha1得到字符串	必要，可通过 getUserInfo 获取

请求数据参考

{
  "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"
}

响应参数参考

参数名	参数说明	备注
token	身份验证标志
user_id	用户ID

响应数据

{
  "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
请求参数

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

请求数据参考

{
  "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 
      }
  ]
}

响应参数

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

响应数据参考

{
  "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
请求参数

参数名	参数说明	备注
order_number	订单编号	必要

请求数据

{ "order\_number": "GD20180507000000000110" }

响应参数

参数名	参数说明	备注
pay	订单对象	可通过 wx.requestPayment(OBJECT)，发起微信支付
timeStamp	时间戳
nonceStr	随机字符串
package	下单接口返回参数
signType	签名算法
paySign	签名
order_number	订单编号

响应数据

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

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，涵盖了95%以上物联网嵌入式知识点，真正体系化！

由于文件比较多，这里只是将部分目录截图出来，全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、电子书籍、讲解视频，并且后续会持续更新

如果你需要这些资料，可以戳这里获取