@jiyiren 2016-04-28T05:52:31.000000Z 字数 8602 阅读 1725

积分管理系统api--员工界面

0、我的任务块

任务的状态根据taskstate来识别。为0表示正在进行任务(显示审字)，为1表示未审阅状态(显示省略号)，为2表示审核通过(显示对号)，为3表示审核不通过(显示错号)；当为2或者3时表示已审阅状态

1、获取我的任务

地址：/staff/selftasks
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": {
"timesort": [
{
"taskid": 5,
"taskname": "打扫卫生",
"taskdesc": null,
"taskscore": 2,
"taskstate": 2,
"isneedpic": 1,
"createat": "2016-03-18 13:19:30",
"finishtime": "2016-03-18 13:19:30"
},
{
"taskid": 7,
"taskname": "计划并汇报当日任务",
"taskdesc": "计划详细点",
"taskscore": 1,
"taskstate": 0,
"isneedpic": 1,
"createat": "2016-03-07 15:44:41",
"finishtime": "2016-03-07 15:44:41"
},
{
"taskid": 6,
"taskname": "擦玻璃",
"taskdesc": null,
"taskscore": 1,
"taskstate": 1,
"isneedpic": 1,
"createat": "2016-03-07 15:44:05",
"finishtime": "2016-03-07 15:44:05"
},
{
"taskid": 3,
"taskname": "再来测试",
"taskdesc": null,
"taskscore": 1,
"taskstate": 0,
"isneedpic": 0,
"createat": "2016-03-06 16:55:52",
"finishtime": "2016-03-07 13:15:07"
}
],
"socresort": [
{
"taskid": 5,
"taskname": "打扫卫生",
"taskdesc": null,
"taskscore": 2,
"taskstate": 2,
"isneedpic": 1,
"createat": "2016-03-18 13:19:30",
"finishtime": "2016-03-18 13:19:30"
},
{
"taskid": 3,
"taskname": "再来测试",
"taskdesc": null,
"taskscore": 1,
"taskstate": 0,
"isneedpic": 0,
"createat": "2016-03-06 16:55:52",
"finishtime": "2016-03-07 13:15:07"
},
{
"taskid": 6,
"taskname": "擦玻璃",
"taskdesc": null,
"taskscore": 1,
"taskstate": 1,
"isneedpic": 1,
"createat": "2016-03-07 15:44:05",
"finishtime": "2016-03-07 15:44:05"
},
{
"taskid": 7,
"taskname": "计划并汇报当日任务",
"taskdesc": "计划详细点",
"taskscore": 1,
"taskstate": 0,
"isneedpic": 1,
"createat": "2016-03-07 15:44:41",
"finishtime": "2016-03-07 15:44:41"
}
]
}
}

失败：暂无数据
{"state":0,"errorcode":1}

2、当日任务

地址：/staff/dailytasks
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": {
"timesort": [
{
"taskid": 3,
"taskname": "再来测试",
"taskdesc": null,
"taskscore": 1,
"taskstate": 0,
"isneedpic": 0,
"createat": "2016-03-06 16:55:52",
"finishtime": "2016-03-07 13:15:07"
}
],
"socresort": [
{
"taskid": 3,
"taskname": "再来测试",
"taskdesc": null,
"taskscore": 1,
"taskstate": 0,
"isneedpic": 0,
"createat": "2016-03-06 16:55:52",
"finishtime": "2016-03-07 13:15:07"
}
]
}
}

失败：暂无数据
{"state":0,"errorcode":1}

3、获取已审阅的任务

地址：/staff/checkedtasks
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": {
"timesort": [
{
"taskid": 5,
"taskname": "打扫卫生",
"taskdesc": null,
"taskscore": 2,
"taskstate": 2,
"isneedpic": 1,
"createat": "2016-03-18 13:19:30",
"finishtime": "2016-03-18 13:19:30"
}
],
"socresort": [
{
"taskid": 5,
"taskname": "打扫卫生",
"taskdesc": null,
"taskscore": 2,
"taskstate": 2,
"isneedpic": 1,
"createat": "2016-03-18 13:19:30",
"finishtime": "2016-03-18 13:19:30"
}
]
}
}

失败：暂无数据
{"state":0,"errorcode":1}

4、获取未审阅的任务

地址：/staff/nocheckedtasks
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": {
"timesort": [
{
"taskid": 6,
"taskname": "擦玻璃",
"taskdesc": null,
"taskscore": 1,
"taskstate": 1,
"isneedpic": 1,
"createat": "2016-03-07 15:44:05",
"finishtime": "2016-03-07 15:44:05"
}
],
"socresort": [
{
"taskid": 6,
"taskname": "擦玻璃",
"taskdesc": null,
"taskscore": 1,
"taskstate": 1,
"isneedpic": 1,
"createat": "2016-03-07 15:44:05",
"finishtime": "2016-03-07 15:44:05"
}
]
}
}

失败：暂无数据
{"state":0,"errorcode":1}

5-0、申请审核的图片上传

地址：/staff/applycheckpic
方法：POST
参数：文件
返回结果：
1. 成功
```
{"state":1,"picuris":"1457500870_0.jpg,1457500870_1.png,1457500870_2.jpg"}
```
2. 失败:无图片参数
  {"state":0,"errorcode":1}
3. 失败：保存失败
  {"state":0,"errorcode":2}

5、申请审核

前端先根据任务的isneed判断是否需要上传附件(图片),显示出的界面要根据这个字段判断显示或者隐藏上传图片的控件，然后再点击申请审核后上传审核信息。

地址：/staff/checktask
方法：POST
参数：
1. taskid(任务id)
2. applydesc(任务描述)
3. applypics(任务的图片,以逗号分隔)
返回结果：
1. 成功：
  {"state":1}
2. 失败：参数为空
  {"state":0,"errorcode":1}
3. 失败：更新出错
  {"state":0,"errorcode":2}

6、获取用户日、月、总积分和日积分百分比

地址：/staff/staffscores
方法：GET
参数：

返回结果：

成功：

{
"state": 1,
"data": {
"dayscores": 1,
"monthscores": 62,
"totalscores": 62,
"percent": 50
}
}

失败：暂无数据
{"state":0,"errorcode":1}

一、我的福利模块

1、获取已经获得的月度福利或者生涯福利

地址：/staff/havedwfs
方法：GET
参数：
1. welfaretype(福利类型,1月度福利，2生涯福利)

返回结果：

成功：返回福利列表

{
"state": 1,
"data": [
{
"pickedstate": 0,//是否被领取,0表示未领取，1表示领取
"qrcode": "766b9bb69a754f533f34ad1915560901",//二维码唯一标识,前端获得到这个值拼成这个地址:http://115.28.138.132/admin/qrcode?qrcode=766b9bb69a754f533f34ad1915560901然后直接放在img的src里就行了，大家可以直接访问这个地址试试会看到二维码，手机扫就会得到这个唯一标识
"comwelfareid": 8,//福利id
"welfarename": "花费补贴",//福利名称
"welfaredesc": "1、授予全新工作者、工作围裙和教学办公用具  2、由原来的12小时工作制变为8小时工作制 ",//福利描述
"picuris": [
"1457525330_0.jpg",
"1457525330_1.jpg",
"1457525330_2.png"
],//福利图片数组，引用地址为:http://115.28.138.132:8088/uploads/welfarepic/1457525330_0.jpg
"money": 20,//福利的价值
"needscore": 60
},
{
"pickedstate": 1,
"qrcode": "766b9bb69a754f533f34ad1915560902",
"comwelfareid": 33,
"welfarename": "春节福利2",
"welfaredesc": "积分达到前不可以开班带学员，达到积分后可根据自身和单位情况开设班级带学员。",
"picuris": [
"1457525330_0.jpg",
"1457525330_1.jpg",
"1457525330_2.png"
],
"needscore": 61,
"money": 0
}
]
}

失败：参数为空
{"state":0,"errorcode":1}
失败：暂无已领取的福利
{"state":0,"errorcode":2}

2、未获得的福利

地址：/staff/nothaswfs
方法：GET
参数：
1. welfaretype(福利类型,1为月度福利，2为生涯福利)

返回结果：

成功：

{
"state": 1,
"data": [
{
"comwelfareid": 35,
"welfarename": "中秋福利2",
"welfaredesc": "积分达到前不可以开班带学员，达到积分后可根据自身和单位情况开设班级带学员。",
"picuris": [
"1457525330_0.jpg",
"1457525330_1.jpg",
"1457525330_2.png"
],
"money": 20,
"needscore": 62
},
{
"comwelfareid": 20,
"welfarename": "大众交通2",
"welfaredesc": "积分达到才可用2",
"picuris": [],
"money": 40,
"needscore": 65
},
{
"comwelfareid": 9,
"welfarename": "生涯花费补贴",
"welfaredesc": "1、授予全新工作者、工作围裙和教学办公用具  2、由原来的12小时工作制变为8小时工作制 ",
"picuris": [
"1457525330_0.jpg",
"1457525330_1.jpg",
"1457525330_2.png"
],
"money": 20,
"needscore": 80
}
]
}

失败:参数为空
{"state":0,"errorcode":1}
失败：暂无未获取的数据
{"state":0,"errorcode":2}

二、积分排行块

1. 获取每日、每月、总积分等排行

地址：/staff/sortscore
方法：GET
参数：
1. scoretype(积分排序类型,1为每日积分排序，2为每月积分排序，3为总积分排序)

返回结果：

成功：

{
"state": 1,
"data": [
{
"userid": 22,
"username": "小朱",
"headpicuri": "1456843474.jpg",//头像，如：http://115.28.138.132/uploads/userpic/1456843474.jpg
"score": 2,//积分，不管每日，每月，总积分等的所有字段都是score
"isself": 22//这个表名是否为自己，如果是则不为空，不是则是null
},
{
"userid": 21,
"username": "小猫子",
"headpicuri": "1456843405.jpg",
"score": 1,
"isself": null
},
{
"userid": 34,
"username": "王五",
"headpicuri": "1456891306.png",
"score": 0,
"isself": null
},
{
"userid": 35,
"username": "王五2",
"headpicuri": "1456986314.jpg",
"score": 0,
"isself": null
},
{
"userid": 36,
"username": "吉吉",
"headpicuri": "1457004953.png",
"score": 0,
"isself": null
}
]
}

失败：参数为空
{"state":0,"errorcode":1}
失败：暂无数据
{"state":0,"errorcode":2}

三、左侧栏

1-1、修改用户头像

地址：/staff/headpic
方法：POST
参数：文件
返回结果：访问图片的地址格式：获得上传图片地址格式:http://115.28.138.132:8088/uploads/userpic/1111.jpg
1. 成功
```
{"state":1,"picuris":"1457500870_0.jpg,1457500870_1.png,1457500870_2.jpg"}
```
2. 失败:无图片参数
  {"state":0,"errorcode":1}
3. 失败：保存失败
  {"state":0,"errorcode":2}

1-2、修改用户信息

地址：/staff/staffinfo
方法：POST
参数：
1. birthyear(出生年)
2. birthmonth(出生月)
3. sex(1为男，2为女)
4. jobinfo(职责描述)
返回结果：
1. 成功
  {"state":1}
2. 失败:参数为空
  {"state":0,"errorcode":1}
3. 失败：更新失败
  {"state":0,"errorcode":2}

1-3、修改密码

地址：/staff/staffpwd
方法：POST
参数：
1. oldpassword(原密码)
2. newpassword(新密码)
返回结果：
1. 成功
  {"state":1}
2. 失败:参数为空
  {"state":0,"errorcode":1}
3. 失败：原密码不正确
  {"state":0,"errorcode":2}
4. 失败：更新失败
  {"state":0,"errorcode":3}

1-4、退出

地址：/staff/loginout
方法：POST
参数：无，需要前端用form表单包住退出按钮，post地址为该地址就行了
返回结果：
无返回结果，直接前台用form提交后由后台跳转到登录页面

1、获取用户信息

地址：/staff/staffinfo
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": {
"staffname": "王五",
"staffnum": "13140999028",
"companynum": "1456841641",
"level": 1,//等级
"headpic": "1456843474.jpg",//图片地址，全地址在：域名+/uploads/userpic/文件名；如：http://115.28.138.132/uploads/userpic/1456842064.jpg
"birthyear": 1970,//新增
"birthmonth": 1,//新增
"sex": 1,//新增,性别1为男，2为女
"jobinfo": "运营猪猪"
}
}

等级说明：（共6个等级）

2、获取待领取任务

地址：/staff/allowedtasks
方法：GET
参数：无

返回结果：

成功：

{
"state": 1,
"data": [
{
"taskid": 6,
"taskname": "擦玻璃",
"taskdesc": "不能有灰尘哦",
"taskscore": 1
},
{
"taskid": 7,
"taskname": "发表读书心得测试",
"taskdesc": "书名，感想等",
"taskscore": 1
}
]
}

失败：无数据
{"state":0,"errorcode":1}

3、选中任务提交

地址：/staff/allowedtasks
方法：POST
参数：
1. taskids(任务ids，以逗号分隔)
返回结果：
1. 成功：failcount如果为0说明都导入成功，如果不为0则说明就有几个任务被别人抢去了。
  {"state":1,"failcount":0}
  2、失败：参数为空
  {"state":0,"errorcode":1}

四、顶部搜索栏

1、获取公司名称和审核状态

地址：/staff/staffcominfo
方法：GET
参数:无

返回结果：

成功：

{
"state": 1,
"data": {
"companyname": "小画家艺术培训",
"state": 0 //0表示未申请审核，1是正在审核中，2表示审核通过，也就是0,1不显示认证的红色图标，2则显示
}
}

失败：无数据
{"state":0,"errorcode":1}

2、搜索任务

地址：/staff/taskbyname
方法：GET
参数：
1. taskname(搜索框里词)

返回结果：

成功：

{
"state": 1,
"data": [
{
"taskid": 2,
"taskname": "再来测试",
"taskdesc": "IKOKOKO",
"taskscore": 2,
"usertaskid": 3,//为空是显示未申请，不为空显示已申请
"taskstate": 0//它设计图上只有审核的图标，表示当前他正在做这个任务，但是有时会搜到已经审核过的任务，所以0表是正在进行就可以显示审核的图标，当为其他则不显示，1为正在申请审核，2为审核通过，3为审核不通过
},
{
"taskid": 7,
"taskname": "发表读书心得测试",
"taskdesc": "书名，感想等",
"taskscore": 1,
"usertaskid": null,
"taskstate": null
}
]
}

失败：参数为空
{"state":0,"errorcode":1}
失败：未搜到与该名称相似的任务
{"state":0,"errorcode":2}

3、搜索福利

地址：/staff/welfaresbyname
方法：GET
参数：
1. wfname(搜索框里的文字)

返回结果;

成功：

{
"state": 1,
"data": [
{
"wfid": 8,
"welfarename": "花费补贴",
"welfaredesc": "1、授予全新工作者、工作围裙和教学办公用具  2、由原来的12小时工作制变为8小时工作制 ",
"money": 20
},
{
"wfid": 9,
"welfarename": "生涯花费补贴",
"welfaredesc": "1、授予全新工作者、工作围裙和教学办公用具  2、由原来的12小时工作制变为8小时工作制 ",
"money": 45
}
]
}

失败：参数为空
{"state":0,"errorcode":1}
失败：未搜到与之有关的福利
{"state":0,"errorcode":2}

4、员工反馈

地址：/staff/feedbacks
方法：POST
参数：
1. contenttype(内容类型1福利期望，2请求建议)
2. content(内容)
返回结果：
1. 成功：
  {"state":1}
2. 失败：参数为空
  {"state":0,"errorcode":1}
3. 失败：插入失败
  {"state":0,"errorcode":2}

5、获取最新公告

地址：/staff/notify
方法：GET
参数：无

返回结果：

成功:

{
"state": 1,
"data": {
"title": "三月份奖品",
"content": "当月第一名小米手机7一台，当月第二名小米智能血压计一台，当月第三名小米手环一个。",
"createat": "2016-03-27 17:42:20"
}
}

失败:暂无公告
{"state":0,"errorcode":1}

积分管理系统api--员工界面

0、我的任务块

1、获取我的任务

2、当日任务

3、获取已审阅的任务

4、获取未审阅的任务

5-0、申请审核的图片上传

5、申请审核

6、获取用户日、月、总积分和日积分百分比

一、我的福利模块

1、获取已经获得的月度福利或者生涯福利

2、未获得的福利

二、积分排行块

1. 获取每日、每月、总积分等排行

三、左侧栏

1-1、修改用户头像

1-2、修改用户信息

1-3、修改密码

1-4、退出

1、获取用户信息

2、获取待领取任务

3、选中任务提交

四、顶部搜索栏

1、获取公司名称和审核状态

2、搜索任务

3、搜索福利

4、员工反馈

5、获取最新公告

内容目录

选择主题