"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

门店/分类/商品/收藏

前言


本教程是基于 “apifm-wxapi” 模块,教你快速实现小程序开发,所以你可能需要先了解以下知识点:


《创建 HelloWorld 项目》

《使用 “apifm-wxapi” 快速开发小程序》

《免费注册开通后台,获得专属域名》


本案例中,部分功能,需要用户登录后才能操作,也就是说需要 token 授权,请先了解:


《微信小程序登录获取openid及三方token》


需要启用的模块


登录 “第一步” 注册的后台,左侧菜单 --> 工厂设置 --> 模块管理


找到并启用下述模块,然后 F5 刷新一下后台界面,你将可以看到本案例所需的所有功能菜单:


  1. 门店管理
  2. 商品分类
  3. 商品管理


后台发布数据


根据你的实际需要,设置并维护好门店、商品分配、商品、物流模板、规格尺寸等数据


设置会员折扣

如果有需要,可以针对不同会员设置不同的折扣,用户在购买商品时候将自动享受该折扣


每日定价

针对酒店、客房预订类、票务、门票类商品,价格和库存每天都会有变化,这个时候,你可以通过该功能对商品进行每日定价


商品限购

可设置不同的会员等级,在约定的时间段范围内只能采购指定数量的商品


门店管理


读取所有的门店列表


1WXAPI.fetchShops(Object object)


参数详见接口文档

支持根据当前用户所在地进行从近到远排序展示


门店详情


1WXAPI.shopSubdetail(id)


id 参数为门店列表返回数据中的 id 字段

该方法可以读取到门店后台设置的扩展属性信息


商品分类


1WXAPI.goodsCategory()


读取后台设置的所有分类数据,分类之间的上下级关系请使用 level 和 pid 进行管理

level = 1 表示 1级类目;2 表示 2级类目,以此类推

pid 代表该类目的上级类目ID(一级类目的 pid = 0)


分类的目录树,可以根据上述2个字段,采用 js 在本地实现


商品管理


获取商品列表


1WXAPI.goods(Object object)


读取所有的商品数据,以分页的形式展示,支持按照多种方式进行排序

具体参数的说明,请查阅接口文档


获取商品详情信息


1WXAPI.goodsDetail(id)


id 参数为上面商品列表方法返回数据里的 id 字段

访问该方法会增加商品的浏览量

该方法获取商品基础信息、商品图文详细介绍、商品图片、可选的规格尺寸、所属分类、快递物流设置信息、商品扩展属性


获取商品的限购设置


1WXAPI.goodsLimitations(goodsId, priceId)


如果商品(列表、详情)信息中 limitation 字段为 true,说明该商品开启了限购,只有设置中的会员等级用户才可以在约定时间内购买不超过指定数量

该方法接收2个参数,goodsId 参数是必填的,代表商品id; priceId 参数非必填,只有在用户购买时候选择了指定的规格尺寸时候才需要传

你可以根据当前登录用户的会员等级,在商品详情页面进行相应的交互展示


获取商品价格「一般用在选择不同规格尺寸后需要实时显示售价」


1WXAPI.goodsPrice(goodsId, propertyChildIds)


goodsId 为商品id

propertyChildIds 参数为用户选择的规格尺寸数据,多个规格尺寸数据用因为逗号分隔,该参数的格式为: 规格id:子属性id,比如: 4:15,2:10 (分别对应了 颜色:红色,内存:256G)


获取商品的每日价格&每日库存「适用酒店预订、票务预订类」


1WXAPI.goodsPriceDaily(goodsId, priceId)


goodsId 为商品id

priceId 为选择的商品规格尺寸记录id,无规格尺寸的商品,无需传该参数


计算物流/快递模板费用计算方法


1WXAPI.goodsPriceFreight(Object object)


具体参数请查阅接口文档

提供快递地址,本方法可计算出本次会计的计费方式


比如: a 件(重量)内 x 元,之后每增加 b 件(重量)额外加收 y 元


拉取当前会员可以显示的折扣信息


1WXAPI.goodsRebate(token, goodsId)


token 为当前登录用户的登录 token

goodsId 为商品id


获取商品的评价


1WXAPI.goodsReputation(Object object)


读取当前商品用户的所有评价数据

具体参数说明请查阅接口文档


商品收藏


收藏某个商品


1WXAPI.goodsFavPut(token, goodsId)


检测当前商品是否已被收藏


1WXAPI.goodsFavCheck(token, goodsId)


获取收藏的商品


1WXAPI.goodsFavList(Object object)


具体参数说明请查阅接口文档

支持分页读取、关键词搜索商品


删除收藏的某个商品


1WXAPI.goodsFavDelete(token, id, goodsId)


id 参数为收藏列表数据中的记录id

goodsId 为商品id

以上2个参数至少要填写1个


关于更加详细的参数使用,以及更加高级的进阶使用方法,可以参考api接口文档说明:


《api接口文档》


关于  apifm-wxapi 更多的使用方法:


《apifm-wxapi使用说明》


本案例Demo代码下载:


《apifm-wxapi使用Demo程序》


期待你的进步!

感谢!