# 前言
本教程是基于 “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. 商品砍价
# 后台进行砍价设置
针对选定的商品，你需要先进行砍价设置：限定总份数、底价、每次能砍掉多少金额[范围]、砍价的有效时间段范围
---
### 获取商品砍价设置
```javascript
WXAPI.kanjiaSet(goodsId)
```
> 读取某个商品的砍价设置信息：总份数、底价、每次能砍掉的（随机）金额以及开始结束时间
>
> 具体可前往后台砍价设置界面了解设置栏目
>
### 发起[创建]砍价，继而邀请好友来帮自己砍到底价
```javascript
WXAPI.kanjiaJoin(token, kjid)
```
> 每个用户针对同一个 kjid 只能参与一次，多次调用本方法将返回上一次砍价的信息
>
> 如果用户对上次砍价结果不太满意，可以调用下面的 **clear** 方法，清空上一次砍价记录，重新发起砍价
>
### 我发起[创建]的砍价详情
```javascript
WXAPI.kanjiaMyJoinInfo(token, kjid)
```
> 查看我发起的砍价目前的进展[进度]情况
>
> 也可以作为判断是否有参与砍价的依据
>
### 放弃上一次砍价
```javascript
WXAPI.kanjiaClear(token, kjid)
```
> 因为每个用户针对同一个 kjid 只能参与一次，如果用户希望再次发起砍价，则必须要先放弃前一次砍价才能进行
>
> 本次操作后，你针对当前 kjid 将查不到砍价记录，砍价数据清空，你可重新调用 **kanjiaJoin** 方法创建一个新的砍价
>
### 砍价详情
```javascript
WXAPI.kanjiaDetail(kjid, joiner)
```
> joiner 参数为发起[创建]砍价的那个用户的 uid，在上述例子中，joiner = 979527
>
> 可查看某人创建的砍价的进度情况，看看多少人参与、目前的价格砍到多少了
>
### 帮好友砍价
```javascript
WXAPI.kanjiaHelp(token, kjid, joiner, remark)
```
> 帮助好友砍价，调用该方法后，将使得好友的当前价格越来越接近底价
>
> joiner 参数为发起[创建]砍价的那个用户的 uid，在上述例子中，joiner = 979527
>
> 被砍到底价、或者截止时间到期后，你将无法再帮助好友进行砍价
>
### 查询我帮好友砍掉的金额
```javascript
WXAPI.kanjiaHelpDetail(token, kjid, joiner)
```
> 查询针对当前 kjid ，我帮忙砍掉的金额
>
> joiner 参数为发起[创建]砍价的那个用户的 uid，在上述例子中，joiner = 979527
>
_关于 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)
期待你的进步！
感谢！