第7章 手机端基础接口文档

作者：ThinkGem

更新日期：2013-12-10

1 传输格式

传输格式均为JSON字符串，使用spring mvc返回对象，并自动通过fasterxml jackson工具类（JsonMapper.java）进行对象到JSON转换。

输出格式符合JSON标准，UTF-8编码。

2 账号登录

http://127.0.0.1:8080/ jeesite/a/login?__ajax=true

提交参数：

用户名： username

密  码： password

验证码： validatjeesite（isValidatjeesiteLogin为true时需要提交验证码）

手机登录：mobileLogin=true

提交方式：POST

获取验证码图片：

http://127.0.0.1:8080/jeesite/servlet/validatjeesiteServlet

3 登录成功

http://127.0.0.1:8080/jeesite/a

{

“id”: “1”,（ID生成策略为UUID，字符串格式，系统自带用户为数值序列）

“loginName”: “system”,（登录名）

“name”: “系统管理员”,（用户姓名）

“mobileLogin”: true,（是否是手机登录）

“sessionid”: “b6b486a8919e4fc196358e10b6a82a2b”（当前用户SESSIONID）

}

4 登录失败

{

“username”: “system”,（登录用户名）

“rememberMe”: false,（是否选择了记住我）

“mobileLogin”: true,（是否是手机登录）

“isValidatjeesiteLogin”: true,（登录三次失败为验证码登录，显示验证码图片）

“message”: “用户或密码错误, 请重试.”（登录失败信息，验证码错误提示验证码错误信息）

}

5 账号退出

http://127.0.0.1:8080/jeesite/a/logout

6 请求页面

6.1 格式

在请求路径后包含会话ID（JSESSIONID一定要大写）即可，格式如下：

URL  = “请求URL” + “;JSESSIONID=”+ “会话ID”

6.2 示例

http://127.0.0.1:8080/jeesite/a/test/test/listData;JSESSIONID=b6b486a8919e4fc196358e10b6a82a2b?__ajax=true

7 获取基础信息

7.1 当前用户信息

http://127.0.0.1:8080/jeesite/a/sys/user/info

7.2 获取区域列表

http://127.0.0.1:8080/jeesite/a/sys/area/treeData

7.3 获取部门列表

http://127.0.0.1:8080/jeesite/a/sys/office/treeData

7.4 获取用户列表

http://127.0.0.1:8080/jeesite/a/sys/user/treeData?officeId=2

返回用户ID需要替换 “u_”，返回原始ID字符串