状态码(state_code)解释

状态码	解释
200	表示请求成功 一切正常
301	重定向，跳转到新的URL
400	请求出现语法错误
401	验证失败
403	资源不可用（没有权限）
404	无法找到指定位置的资源。
405	请求方法（GET、POST、HEAD、Delete、PUT、TRACE等）对指定的资源不适用。
500	服务器遇到了意料不到的情况，不能完成客户的请求。
501	服务器不支持实现请求所需要的功能。

登陆

获取用户信息，并传给数据库；
简单流程如下图：

登陆流程
前台通过小程序接口获取code，将获取到的code发送到后台，后台通过appid+appsecret+code发送给微信服务器以获取session_key和openid。

首页

 url :XXX.com/index.php/home/Index/index

获取用户地理位置，通过wx.getLocation(OBJECT)方法。

OBJECT参数说明：

参数	类型	必填	说明
type	String	否	默认为"wgs84"返回gps坐标，"gcj02"返回可用于wx.openLocation的坐标
success	Function	是	接口调用成功的回调函数，返回内容详见返回参数说明。
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success返回参数说明：

参数	说明
latitude	纬度，浮点数，范围为-90~90，负数表示南纬
longitude	经度，浮点数，范围为-180~180，负数表示西经
speed	速度，浮点数，单位m/s
accuracy	位置的精确度
altitude	高度，单位 m
verticalAccuracy	垂直精度，单位 m（Android 无法获取，返回 0）
horizontalAccuracy	水平精度，单位 m

示例代码：

wx.getLocation({
    type: 'wgs84',
    success: function (res) {
        var latitude = res.latitude
        var longitude = res.longitude
        var speed = res.speed
        var accuracy = res.accuracy
    }
})

前台将纬度(latitude)，经度(longitude)数据传给后台(POST)，后台根据经纬度计算距离并排序商戶，将数据传给前台，并将用户基本资料传给前台.前台显示会员卡号，商家列表等信息。
OBJECT参数说明：

参数	说明
latitude	纬度，浮点数，范围为-90~90，负数表示南纬
longitude	经度，浮点数，范围为-180~180，负数表示西经

success返回参数说明：

参数	说明
state_code	状态码
admin_name	商户id
merchant_name	商户名称
merchant_images	商户头像
telephone	商户电话(预定使用)
user_spend	人均消费价格
dish_list	赠送菜品
price	菜品价格
rule	赠送规则
merchant_latitude	商户纬度
merchant_longitude	商户经度
long	用户当前与商家距离
tel	用户电话
vip_card	会员卡号
vip_start_time	会员开始时间
vip_end_time	会员结束时间

返回json示例：
{"state_code":"200","user_info":{"id":"1","openid":"121","tel":null,"vip_start_time":"2017-08-07","vip_end_time":"2017-10-07","vip_card":null},"merchant_list":{"2":{"id":"3","merchant_name":null,"merchant_images":null,"user_spend":null,"telephone":null,"dish_list":null,"merchant_latitude":"34.2619515371","merchant_longitude":"108.9546080475","merchant_area":null,"merchant_address":null,"price":null,"rule":"\u706b\u9505\u6492\u65e6","long":0.17090961396683},"0":{"id":"1","merchant_name":"\u706b\u9505","merchant_images":null,"user_spend":null,"telephone":null,"dish_list":null,"merchant_latitude":"34.2466456176","merchant_longitude":"108.9975285530","merchant_area":null,"merchant_address":null,"price":null,"rule":null,"long":4.1337967241545},"1":{"id":"2","merchant_name":null,"merchant_images":null,"user_spend":null,"telephone":null,"dish_list":null,"merchant_latitude":"34.2219515371","merchant_longitude":"108.9025152151","merchant_area":null,"merchant_address":null,"price":null,"rule":null,"long":6.6433857961773}}}

搜索

用户在搜索框内输入搜索内容，前台将内容传给后台进行处理
OBJECT参数说明：

参数	说明
search_text	用户输入内容

success返回参数说明：
同上

{"state_code":"200","$merchant_list":[{"id":"1","merchant_name":"\u706b\u9505","merchant_images":null,"user_spend":null,"merchant_area":null,"merchant_address":null,"price":null,"rule":null},{"id":"3","merchant_name":null,"merchant_images":null,"user_spend":null,"merchant_area":null,"merchant_address":null,"price":null,"rule":"\u706b\u9505\u6492\u65e6"}]}

商户详情页

url:XXX.com/index.php/home/merchant/merchant_info?merchant_id=XXX

OBJECT参数说明：

参数	说明
merchant_id	店铺id

success返回参数说明：

参数	说明
state_code	状态码
merchant_name	商户名称
merchant_banner	banner轮播图
merchant_address	商户地址
opening_time_begin	开始营业时间
opening_time_end	结束营业时间
telephone	商户电话(预定使用)
user_spend	人均消费价格
dish_list	赠送菜品
price	菜品价格
rule	赠送规则
merchant_intro	商户介绍

json示例:
{"state_code":"200","merchant_info":{"merchant_name":null,"merchant_banner":null,"merchant_address":null,"opening_time_begin":null,"opening_time_end":null,"telephone":null,"user_spend":null,"dish_list":null,"price":null,"rule":null,"merchant_intro":null}}

享用项目

用户在商家消费之后享受赠送菜品服务之后在工作人员的见证下进行核销操作。
在首页点击享用按钮，弹出核销窗口，点击和进行核销。

url:XXX.com/index.php/home/consume/index？merchant_id=XXX

OBJECT参数说明：

参数	说明
merchant_id	商户id

success返回参数说明：

参数	说明
state_code	状态码
200	表示核销成功，弹出成功的提示
401	表示该用户今日在本店已经核销过两次，达到次数上限
403	用户会员已经到期或者未开通，跳到首页让用户选择购买

会员购买

url:XXX.com/index.php/home/vip/open_vip？card_id=XXX

OBJECT参数说明：

参数	说明
card_id	会员卡类型(1:月卡，2：季度卡，3：年卡)

会员需要先绑定手机号码，购买前先判断是否绑定，绑定完成之后才让购买。

手机号绑定

前台提供一个输入框，用户将手机号输入之后点击获取验证码，前台将手机号码POST给后台接口。
用户输入验证码后，再将用户输入的验证码传给后台处理

url:XXX.com/index.php/home/consume/bind_tel

OBJECT参数说明：

参数	说明
telephone	手机号码

success返回参数说明：

参数	说明
state_code	短信发送状态（200：短信发送成功；500：短信发送失败；401手机号码格式错误）

当用户接收到验证短信时并输入提交时，前台将验证码POST给后台。

url:XXX.com/index.php/home/consume/validate_code

OBJECT参数说明：

参数	说明
vCode	验证码

参数	说明
state_code	验证状态（200：验证成功；500：验证失败）

success返回参数说明：

参数	说明
state_code	验证状态（200：验证成功；500：验证失败）