# 前言
本教程是基于 “apifm-wxapi” 模块，教你快速实现小程序开发，所以你可能需要先了解以下知识点：
[《创建 HelloWorld 项目》](https://www.yuque.com/apifm/doc/hezlrm)
[《使用 “apifm-wxapi” 快速开发小程序》](https://www.yuque.com/apifm/doc/mdldsd)
[《免费注册开通后台，获得专属域名》](https://www.yuque.com/apifm/doc/qr6l4m)
本案例中，部分功能，需要用户登录后才能操作，也就是说需要 token 授权，请先了解：
[《微信小程序登录获取openid及三方token》](https://www.yuque.com/apifm/doc/kaygbw)
本例砍价功能，需要商品功能支持，没有商品何来砍价呢，所以你要先了解：
[《使用 apifm-wxapi 开发微信小程序之门店/分类/商品/收藏》](https://www.yuque.com/apifm/doc/excd2w)
# 需要启用的模块
登录 “第一步” 注册的后台，左侧菜单 --> 工厂设置 --> 模块管理
找到并启用下述模块，然后 F5 刷新一下后台界面，你将可以看到本案例所需的所有功能菜单：
_本案例菜单为 “营销辅助” --> “拼团设置” + “开团记录” + “团购记录”_
1. 商品拼团
# 后台进行砍价设置
1. 编辑商品，在商品编辑页面有一个 “开启拼团” 的下拉选项，请选择开启拼团；
2. 在商品编辑页面，设置好团购价格；
3、在拼团设置中，配置商品的团购信息，成团人数，超时时间，未成团的退款方式
---
### 获取某一个商品的拼团配置
```javascript
WXAPI.pingtuanSet(goodsId)
```
> 读取团购的几个重要设置：几人成团、超时时间、超时未成团后如何退款等等
>
### 批量获取一组商品的拼团配置
```javascript
WXAPI.pingtuanSets(goodsIdArray)
```
> 针对上面方法的补充，在有必要的场合可以一次性的读取多个商品的团购配置信息
>
> goodsIdArray 为商品ID的数组: [1,2,3,4,5]
>
### 开团[我发起一个团购，我是团长，让别人来参加]
```javascript
WXAPI.pingtuanOpen(token, goodsId)
```
> 开团成功后，团长要先自己下单并且完成支付，团才算是真正开启成功！
>
> 仅开团，团长自己不支付，后台可以看见开团信息，但是其他用户看不到该团购，团长完成支付后才可以看见并参与
>
### 获取某个商品当前进行中的所有拼团
```javascript
WXAPI.pingtuanList(Object object)
```
> 拉取某个商品当前所有的开团列表数据，用于展示当前商品的多组进行中/已完成的团购数据，你也可以选择其中一个团购加入购买以便可以早点成团
>
> 当然你也可以自己新开一个团购队列，让别人来参与，这个时候本方法将能多返回你刚刚开的团的信息 **团长必须完成支付后才能在这里显示**
>
### 获取某个团购的参与用户列表
```javascript
WXAPI.pingtuanJoinUsers(tuanId)
```
> tuanId 为上述例子中的团号，也就是 7380，不是 2
>
### 读取我参与过的所有团购记录
```javascript
WXAPI.pingtuanMyJoined(Object object)
```
> 具体参数请查阅接口文档
>
> 用以展示在个人中心 --> 我参与的所有团购，可分页
>
**关于更加详细的参数使用，以及更加高级的进阶使用方法，可以参考api接口文档说明：**
[《api接口文档》](https://api.it120.cc/doc.html)
_关于 apifm-wxapi 更多的使用方法：_
[《apifm-wxapi使用说明》](https://github.com/gooking/apifm-wxapi/blob/master/instructions.md)
_本案例Demo代码下载：_
[《apifm-wxapi使用Demo程序》](https://github.com/gooking/apifm-wxapi-demo)
期待你的进步！
感谢！