接口文档_优就业办公系统_web实训项目

接口清单

接口详解

接口清单

接口名称	调用地址	调用方式
用户登录	http://localhost:9999/login	POST

接口详解

用户登录

请求地址

http://localhost:9999/login

请求参数

参数名称	类型	描述
username	String	用户名
password	String	密码

返回参数

{
    "status": 1,
    "message": "用户合法",
    "data": {
        "_id": "5f144eab52cda82c78ff7ab3",
        "__v": 0
    }
}

用户列表

请求地址

http://localhost:9999/user/list

请求参数

无请求参数

返回参数

[
    {
        "_id": "5f144e5b90fa5028a0795064",
        "username": "ceshi",
        "password": "123123",
        "phone": "123412342134",
        "email": "ceshi@qq.com",
        "role_id": "5e18441f7d522474bbe1fdfd",
        "create_time": 1555061581734,
        "role": {
            "menus": []
        },
        "__v": 0
    },
    {
        "_id": "5f144e6f8b06671a60c96ae3",
        "username": "jingli",
        "password": "123123",
        "phone": "13623362563",
        "email": "jingli@qq.com",
        "role_id": "5e1844297d522474bbe1fdfe",
        "create_time": 1555061609666,
        "role": {
            "menus": []
        },
        "__v": 0
    }
]

用户删除

请求地址

http://localhost:9999/login

请求参数

参数名称	类型	描述
_id	String	用户ID

返回参数

{
    "status": 1
}

用户添加

请求地址

http://localhost:9999/user/add

请求参数

参数名称	类型	描述
username	String	用户名
password	String	密码
phone	String	电话号码
email	String	邮箱
role_id	Object	角色对象

返回参数

    {
        "_id": "5f55a519a3d8161fcce79e46",
        "username": "test",
        "password": "123123",
        "phone": "1111111",
        "email": "11111@163.com",
        "role_id": "0",
        "create_time": 1599448345043,
        "role": {
            "menus": []
        },
        "__v": 0
    }

用户更新

请求地址

http://localhost:9999/login

请求参数

参数名称	类型	描述
username	String	用户名
phone	String	电话
email	String	邮箱
_id	String	用户ID

返回参数

    {
        "_id": "5f55a519a3d8161fcce79e46",
        "username": "test123",
        "password": "123123",
        "phone": "2222",
        "email": "2222@163.com",
        "role_id": "0",
        "create_time": 1599448345043,
        "role": {
            "menus": []
        },
        "__v": 0
    }

员工列表

请求地址

http://localhost:9999/personnel/list

请求参数

无参数请求

返回参数

[
    {
        "categorys": [
            {
                "key": "1",
                "name": "财务"
            },
            {
                "key": "2",
                "name": "行政"
            },
            {
                "key": "3",
                "name": "人力"
            },
            {
                "key": "4",
                "name": "市场"
            },
            {
                "key": "5",
                "name": "研发"
            },
            {
                "key": "6",
                "name": "话务"
            },
            {
                "key": "7",
                "name": "培训"
            },
            {
                "key": "8",
                "name": "师资"
            }
        ],
        "_id": "5f142479de2642247cc8c165",
        "status": 1,
        "__v": 0
    }
]

日志列表

请求地址

http://localhost:9999/daily/list

请求参数

无请求参数

返回参数

[
    {
        "_id": "5f144d467bda842e7ce1b9eb",
        "title": "第一月月报",
        "date": "2020-01-03",
        "summary": "第一月总结内容",
        "plan": "下一月的计划",
        "feel": "本月的工作感受",
        "__v": 0
    }
]

日志添加

请求地址

http://localhost:9999/login

请求参数

参数名称	类型	描述
title	String	标题
time	String	时间
summary	String	摘要
plan	String	计划
feel	String	感觉

返回参数

{
    "status": 1,
    "message": "用户合法",
    "data": {
        "_id": "5f144eab52cda82c78ff7ab3",
        "__v": 0
    }
}

日志更新

请求地址

http://localhost:9999/daily/update

请求参数

参数名称	类型	描述
_id	String	用户名
title	String	标题
date	String	日志日期
summary	String	日志总结
plan	String	日志计划
feel	String	员工感受

返回参数


    {
        "_id": "5f144d467bda842e7ce1b9eb",
        "title": "第一月月报",
        "date": "2020-01-03",
        "summary": "第一月总结内容",
        "plan": "下一月的计划",
        "feel": "本月的工作感受",
        "__v": 0
    }

管理列表

请求地址

http://localhost:9999/manage/list

请求参数

无请求参数

返回参数

{
    "status": 1,
    "data": [
        {
            "menus": [
                "/home",
                "/attence",
                "/daily",
                "/information",
                "/personnel",
                "/life",
                "/performance",
                "/go"
            ],
            "_id": "5f144dc857ab4930c0ce2795",
            "name": "测试",
            "create_time": 1554639521749,
            "__v": 0,
            "auth_time": 1558679920395,
            "auth_name": "test007"
        },
        {
            "menus": [],
            "_id": "5f1451baf7d3950db0e7baab",
            "name": "开发",
            "create_time": 1595167162287,
            "__v": 0
        }
    ]
}

管理添加

请求地址

http://localhost:9999/manage/add

请求参数

参数名称	类型	描述
username	String	管理者名称

返回参数

    {
            "menus": [],
            "_id": "5f55d11d31cca420fc54435a",
            "name": "新管理者",
            "create_time": 1599459613093,
            "__v": 0
        }

管理更新

请求地址

http://localhost:9999/manage/update

请求参数

参数名称	类型	描述
_id	String	用户名
menus	String	菜单对象
auth_time	String	管理者时间

返回参数

 {
            "menus": [
                "/home",
                "/attence",
                "/daily",
                "/information",
                "/personnel",
                "/life"
            ],
            "_id": "5f144e11addf663038ad983d",
            "name": "角色1",
            "create_time": 1554639552758,
            "__v": 0,
            "auth_time": 1557630307021,
            "auth_name": "admin"
        },

绩效列表

请求地址

    http://localhost:9999/login

请求参数

无请求参数

返回参数

{
    "status": 1,
    "docs": [
        {
            "dataX": [
                "一月",
                "二月",
                "三月",
                "四月",
                "五月",
                "六月",
                "七月"
            ],
            "dataNumber": [
                "1.3",
                "1.0",
                "1.1",
                "1.5",
                "1.2",
                "1.3",
                "1.2"
            ],
            "_id": "5f144efa6cd44b01b0857ad2",
            "__v": 0
        }
    ]
}

外出列表

请求地址

http://localhost:9999/go/list

请求参数

无请求参数

返回参数

{
    "status": 1,
    "docs": [
        {
            "start": "京忱润业",
            "_id": "5f144f32b4303914b8238d17",
            "end": "故宫",
            "time": 1555061581734,
            "__v": 0
        },
        {
            "start": "京忱润业",
            "_id": "5f1451faf7d3950db0e7baac",
            "end": "成都",
            "time": 1595167226374,
            "__v": 0
        },
        {
            "start": "京忱润业",
            "_id": "5f145208f7d3950db0e7baad",
            "end": "成都人南立交",
            "time": 1595167240778,
            "__v": 0
        }
    ]
}

外出添加

请求地址

http://localhost:9999/go/add

请求参数

参数名称	类型	描述
start	String	起始地址
end	String	到达地址
time	String	时间

返回参数

{
	"start": "京忱润业",
	"_id": "5f1451faf7d3950db0e7baac",
	"end": "成都",
	"time": 1595167226374,
	"__v": 0
}

出勤率列表

请求地址

http://localhost:9999/login

请求参数

无请求参数

返回参数

{
    "status": 1,
    "docs": [
        {
            "state": 1,
            "_id": "5f144f5b81793b1aa0c56862",
            "date": "2020-01-2",
            "__v": 0
        }
    ]
}

出勤率添加

请求地址

http://localhost:9999/attendance/add

请求参数

参数名称	类型	描述
date	String	时间
state	String	出勤状态

返回参数

{
	"state": 1,
	"_id": "5f144f5b81793b1aa0c56862",
	"date": "2020-01-2",
	"__v": 0
}