[关闭]
@jiyiren 2016-04-29T13:01:56.000000Z 字数 52634 阅读 1395

积分管理系统api

后台API接口说明
* 服务器根地址baseurl: http://115.28.138.132
* 以下的不全的api地址都要加上baseurl.服务器端已经设置允许所有请求了,所以跨域和不跨域都可以用同一个url访问了
* 员工页面api(旭山):https://www.zybuluo.com/chenxushan/note/309615(旭山里的api都已被重写,api看下面的链接,里面的js图片上传还在旭山的这个页面里)
* 员工界面api(吉毅):https://www.zybuluo.com/jiyiren/note/317314
* 测试页面信息:https://www.zybuluo.com/jiyiren/note/331034
* 反馈信息页面:https://www.zybuluo.com/jiyiren/note/333430
* 公司管理界面:
1. 任务体系开发:http://form.mikecrm.com/f.php?t=Mem8KJ
2. 福利体系开发:http://form.mikecrm.com/f.php?t=rkrmYL
3. 增值服务:https://www.zybuluo.com/jiyiren/note/309469

图片地址:
* 头像地址:http://115.28.138.132:8088/uploads/userpic/1111.jpg
* 福利地址:http://115.28.138.132:8088/uploads/welfarepic/1111.jpg
* 优惠地址:http://115.28.138.132:8088/uploads/discountpic/1111.jpg
* 认证地址:http://115.28.138.132:8088/uploads/authen/1111.jpg
* 员工申请任务审核地址:http://115.28.138.132:8088/uploads/applycheck/1111.jpg
* 小的bug 朝伟:https://www.zybuluo.com/jiyiren/note/334924
* 合并分支事项:https://www.zybuluo.com/jiyiren/note/354656

零、测试模块

1、单图和多图测试

  1. 页面:

    • 地址:/test/pictest
    • 方法:GET
  2. 上面页面提交的api

    • 地址:/test/pictest
    • 方法:POST
    • 说明:如果是多张图片,上传的控件的name要都不一样,名称则随便起

一、系统管理员后台

1、左侧栏块

1、(汇总)员工总人数、总充值量、总点击量

下面的三个方法还是可以用的,只不过返回的字段里也都加了state字段,表示该公司是否已经认证,如果为0表示为认证,如果为2表示已经认证,如果为1表示正在申请审核(这个前端就无需判断了)。如果可以,就换成这个单方法,传一个参数三个数据格式都一致就可以操作一次了。

1、(更新加入了state)获取各个公司员工总人数并降序排序

下面两个相同,state字段表示该公司是否认证,0表示未认证,2表示已认证,1表示正在认证(这个前端无需判断)

2、获取各个公司总充值量并降序排序

3、获取各个公司总点击量并降序排序

4、热度分析--获取公司类型

5、热度分析--经典任务

6、热度分析--人气福利

7、点击公司名--根据公司id获取公司的信息

8、点击公司名--获取供应商订单

9、点击公司名称--公司信息里的提醒充值

10、点击公司名称--充值

10-1、点击公司名称--充值记录

11、获取管理员信息(头像、名字)

12、点击公司名--审核通过

13、修改root管理员头像

14、获取root管理员信息(更新)

15、修改root管理员信息

16、修改root管理员密码

17、退出登录

2、设置初始任务包块

1、获取初始包

2、添加公司类型(添加初始大任务包)

3、获取系统任务包列表

4、添加系统任务包

5、获取系统任务列表

6、发布任务

7、编辑任务

8、删除任务

3、添加供应商及优惠项目块

1、获取供应商类型列表

2、添加供应商类型

3、获取供应商列表(根据类型id)

4、(修改)获取供应商信息(根据供应商id)

5、添加供应商,修改供应商

6、上传优惠图片

7、添加优惠

4、设置初始福利包块

1、获取初始福利包列表

2、添加初始化福利包

3、每月或生涯福利包--相关卡券选择--获取优惠

3-1、获取供应商类型,供应商和优惠

4、福利图片上传地址

5、每月或生涯福利包--发布福利

6、获取月度福利,获取生涯福利

7、修改福利

8、删除福利

5、供应商福利块

1、第三方优惠--获取供应商和优惠列表

2、需发货--获取订单信息

3、需发货--发货反馈

4、付款--确认付款

点击付款按钮后,弹窗的界面中金钱数目前端根据已经有的优惠中的money乘以公司需要的件数就是金钱数目,而付款方的名称就是供应商的名称。然后点击确认付款的时候,调用下面的方法

6、顶部搜索栏块

1、按公司名查询--公司名称列表

此处的搜索用前端匹配方式,先前端获取所有公司的名称,然后用户搜索后匹配,将匹配的列表表示,然后用户点击某个公司名称,则前端获取该公司id,然后以该id作为参数请求公司信息。公司信息的api和点击公司头像那里的一致。

2、按公司名称查询--获取订单信息

3、按供应商名查询--获取供应商名称数组

前端搜索控件匹配,匹配到后获取对应的id,再用id,获取供应商的所有信息,获取供应商信息api与添加供应商及优惠项目里的一样

4、按名称搜索

4.1、按供应商名查询--供应商信息和优惠

4.2、按供应商名查询--供应商提供礼品福利

5、用户反馈

二、公司管理后台

1、积分排名块

1、(更新)获取日、月、总积分排名(根据公司id)

2、任务发布块

1、(更新)任务发布--获取所有用户名和id(任务对象)

2、(更新)发布任务

3、任务审核块

1、等待审核与已审核任务列表与左侧栏块的查看任务里的api完全一致

4、左侧栏块

1、(更新)企业信息设定--获取公司相关信息

2、(修改)企业信息设定--修改公司相关信息

3、(更新)初始化任务包---获取初始化的任务包列表

4、(更新)初始化任务包--获取初始化任务列表(要去重)

5、(更新)初始化任务包--导入单任务

这个api有点烦,前端也要处理的数据较多。用户选中单个或者多个任务,导入时,前端要循环导入单任务。

6、查看任务--获取日常任务列表

7、查看任务--获取临时任务列表

8、查看任务--查看申请人

8-1、修改任务

不能用于初始化任务里的修改任务,可以用于查看任务里的修改任务,初始化任务里的任务的修改只在内存里修改,也就是不调用api

8-2、删除任务

9、查看任务--获取等待审核的任务列表

10、查看任务--获取已经审核过的任务列表

10、(更新)查看任务--查看员工任务

11、审核通过(批量)

12、审核批量不通过

12-1、取消审核通过或者不通过

13、(更新)账号管理--获取所有用户账号

14、(更新)账号管理--账号删除

14-1、账号管理--用户信息修改

14-2、账号管理--获取公司代码

15、(更新)初始化福利包--获取月度福利和生涯福利

16、导入福利包--导入系统福利到公司福利

17、查看福利--获取每月福利和生涯福利

18、福利库存

19、福利库存--提醒发货

20、福利收货--获取供应商

21、福利收货--获取优惠(根据公司供应商表id)

22、福利收货--确认收货

23、福利金充值

点击福利金充值显示该公司的金额,已低于的字样根据lowpercent来判断是否显示,点击充值时只要显示系统管理员的支付宝二维码就行了。

24、福利领取情况--员工福利领取情况

25、获取管理员信息(名称,头像,职责等)

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

27-0、发表通告图片上传地址

27、发表通告

28、获取通告列表

29、修改管理员头像

31、修改管理员信息

32、修改密码

33、退出

34、福利领取--获取用户和福利信息

UI图说明:https://www.zybuluo.com/jiyiren/note/340107

35、领取福利--领取

UI图说明:https://www.zybuluo.com/jiyiren/note/340107

36、生成管理员账号

5、新福利导入块

1、获取新福利导入包(就是主题名称)

2、根据主题包获取包里福利列表

3、查同

4、新福利导入

6、最上搜索栏块

1、需求反馈

2、查询所有任务名

3、根据任务id查询出任务详情(暂时无用)

4、查询所有员工姓名

5、根据员工id查询员工信息

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

9、获取最新公告

10、反馈新增api

三、用户登录注册模块

1、员工登录或者公司管理员登录

2、公司信息注册和公司管理员注册

3、员工注册

4、员工登录

5、检查手机号或者email是否存在

6、检查公司代码是否存在

四、员工界面

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注