JEESITE快速开发平台(九)手机端基础接口文档 - 化妆舞会

时间:2024-01-29 21:46:15

JEESITE快速开发平台(九)手机端基础接口文档

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字符串