用户端接口文档.docx

用户端接口文档-詹亚磊2017/01/05 版本记录 版本记录 日期 提交人 备注 V1.0 2017-01-05 詹亚磊 APP（魅客用户端）接口文档 登录模块 1、用户登录接口 接口说明 接口描述 用户登录接口 访问地址 /user/free/login.do 请求方式 GET/POST 请求格式 JSON 返回格式 JSON 开发人 詹亚磊 备注 用户第一次登录则进行注册，返回用户信息 请求参数说明 请求参数名 必填 类型 请求参数说明 cid true String 个推cid userAccount true string 登录信息（手机号或微信账号） type true int 登录类型（是手机号登录还是第三方微信登录1：phone登录 ，2：wechat登录） nickName false string 微信注册（或登录）时获取的微信昵称 photo false string 微信注册（或登录）时获取的微信头像 返回结果说明 返回参数 参数类型 返回参数说明 单个对象数据 code int 返回码 msg string 返回信息 data MmUser Model模型 返回码说明 返回码（reponse_code） 说明 200 请求成功 400 请求失败（登录信息有误！） 2、用户免登录接口 接口说明 接口描述 用户免登录接口 访问地址 /user/free/autoLogin.do 请求方式 GET/POST 请求格式 JSON 返回格式 JSON 开发人 陈天兰 备注 用户免登录 请求参数说明 请求参数名 必填 类型 请求参数说明 userId true int 用户id token true string 用户token(token在json请求数据中传递) 返回结果说明 返回参数 参数类型 返回参数说明 单个对象数据 code int 返回码 msg string 返回信息 data MmUser Model模型 返回码说明 返回码（reponse_code） 说明 200 请求成功 400 请求失败（免登录信息有误！） 3、用户退出接口 接口说明 接口描述 用户退出接口 访问地址 /user/logout.do 请求方式 GET/POST 请求格式 JSON 返回格式 JSON 开发人 刘辉 备注 用户退出登录，清空token 请求参数说明 请求参数名 必填 类型 请求参数说明 userId true int 当前用户ID token true string 用户携带的token 返回结果说明 返回参数 参数类型 返回参数说明 单个对象数据 code int 返回码 msg string 返回信息 data int 更新影响条数（row = 1退出成功，row1失败） 返回码说明 返回码（reponse_code） 说明 200 请求成功 400 请求失败（退出登录有误！） 首页模块 4、首页根据等级展示接口 接口说明 接口描述 首页等级排序接口 访问地址 /user/free/gradeList.do 请求方式 GET/POST 请求格式 JSON 返回格式 JSON 开发人 詹亚磊 备注 （显示所有通过审核且在服务状态的妹子）等级降序 请求参数说明 请求参数名 必填 类型 请求参数说明 pageNumb true int 当前页码（从1开始，第几页） lat true string 用户当前维度 lag true string 用户当前经度 返回结果说明 返回参数 参数类型 返回参数说明 Map对象数据 code int 返回码 msg string 返回信息 babyList ListUserHomeResponse Model模型 bannerList ListSysBanner Model模型 返回码说明 返回码（reponse_code） 说明 200 请求成功 400 请求失败（没有查询到妹子信息） 5、首页根据距离展示接口 接口说明 接口描述 首页距离排序接口 访问地址 /user/free/distanceList.do 请求方式 GET/POST 请求格式 JSON 返回格式 JSON 开发人 詹亚磊 备注 （显示所有通过审核且在服务状态的妹子）与用户距离降序 请求参数说明 请求参数名 必填 类型 请求参数说明 pageNumb true int 当前页码（从1开始，第几页） lat true string 用户当前维度 lag true string 用户当前经度 返回结果说明 返回参数 参数类型 返回参数说明 Map对象数据 code int 返回码 msg string 返回信息 babyList ListUserHomeResponse Model模型 bannerList