# 报名系统技术文档0819 **Repository Path**: Tim_PHPer/bmxt ## Basic Information - **Project Name**: 报名系统技术文档0819 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2019-08-19 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ### 报名系统技术文档 **1\. 获取验证码** ###### 接口功能 > 可以用于后台用户登录或者前台用户进行会议查看 ###### URL > [http://www.api.com/captcha] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | seed | 否 | int | 随机数，避免图片缓存 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | ###### 接口示例 > 地址：[http://www.api.com/captcha] ``` 图片格式返回 ``` **2\. 用户登录 后台** ###### 接口功能 > 后台所有操作必须要登录 ###### URL > [http://www.api.com/admin/login/loginAjax] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | username | 是 | string | 用户账号 | | password | 是 | string | 用户密码 | | vercode | 是 | string | 验证码 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | | data| array| 错误信息数组 | | data[code]| int| 4001:用户名或密码输入有误 4002:该用户已被禁用 4003:该账户已被删除，请联系超级管理员！4004:验证码出错 | ###### 接口示例 > 地址：[http://www.api.com/admin/login/loginAjax] ``` { "code": 1, "msg": "验证码输入有误，请点击更换重试", "data": { "code": 4004 } } ``` **3\. 添加会议 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/blog.activity/add] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | name| 是 | string | 会议名称 | | is_show_job| 是 | int| 是否职务合并显示 | | content | 是 | string | 内容 | | field1| 否 | string| 自定义字段1 | | field2| 否 | string| 自定义字段2 | | field3| 否 | string| 自定义字段3 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | | data| int| 添加成功则返回id | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/add] ``` { "code": 0, "msg": "会议添加成功！", "data": "6" } ``` **4\. 修改会议 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/blog.activity/edit] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int| 会议id | | name| 是 | string | 会议名称 | | is_show_job| 是 | int| 是否职务合并显示 | | content | 是 | string | 内容 | | field1| 否 | string| 自定义字段1 | | field2| 否 | string| 自定义字段2 | | field3| 否 | string| 自定义字段3 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/add] ``` { "code": 0, "msg": "会议修改成功！", "data": "" } ``` **5\. 删除会议** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/blog.activity/del] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/del?id=5] ``` { "code": 0, "msg": "会议删除成功！", "data": "" } ``` **6\. 禁用或启用会议** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/blog.activity/status] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/del?id=5] ``` { "code": 0, "msg": "禁用成功！", "data": "" } ``` **7\. 获取某条会议签到记录 后台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/blog.activity/getrecord] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议记录id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array| 会议信息数组 | | data[id]| int | 用户ID | | data[activity_id]| string | 所属会议id | | data[field1]| string | 自定义字段1 | | data[field2]| string | 自定义字段2 | | data[field3] | string | 自定义字段3 | | data[name]| string | 姓名| | data[branch_name]| string | 部门名称| | data[keshi_name]| string | 科室名称| | data[city]| string | 城市 市| | data[district]| string | 城市 区| | data[sex]| string | 性别 (1：男，2：女）| | data[telephone]| string | 固话| | data[phone]| string | 手机号码| | data[telephone]| string | 固话| | data[is_save]| int | 是否住宿 1是 0否| | data[remark]| string | 备注| | data[status]| int | 是否禁用 (0：否，1：是）| | data[activity_name]| string | 会议名称| ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/getrecord?id=5] ``` {"code":0,"msg":"\u63d0\u4ea4\u6210\u529f\uff01","data":{"id":24,"activity_id":4,"field1":"field11","field2":"field21","field3":"field31","name":"name1","branch_name":"branch_name1","keshi_name":"keshi_name1","city":"city1","district":"district1","sex":1,"telephone":"23123123123","phone":"123123123123","is_save":1,"remark":"remark","activity_name":"\u4f1a\u8bae\u540d\u79f0"}} ``` **8\. 获取某会议的所有签到记录 后台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/blog.activity/getActRecord] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议记录id | | page| 否 | int| 页码 默认1 | | limit| 否 | int| 每页显示数 默认10| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array| 会议信息数组 | | data[][id]| int | 用户ID | | data[][activity_id]| string | 所属会议id | | data[][field1]| string | 自定义字段1 | | data[][field2]| string | 自定义字段2 | | data[][field3] | string | 自定义字段3 | | data[][name]| string | 姓名| | data[][branch_name]| string | 部门名称| | data[][keshi_name]| string | 科室名称| | data[][city]| string | 城市 市| | data[][district]| string | 城市 区| | data[][sex]| string | 性别 (1：男，2：女）| | data[][telephone]| string | 固话| | data[][phone]| string | 手机号码| | data[][telephone]| string | 固话| | data[][is_save]| int | 是否住宿 1是 0否| | data[][remark]| string | 备注| | data[][status]| int | 是否禁用 (0：否，1：是）| | data[][activity_name]| string | 会议名称| | page_info| array| 页数数组 | | page_info[limit]| int | 每页显示数 | | page_info[page_current]| int | 当前页码 | | page_info[page_sum]| int | 总共页数 | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/getActRecord] ``` {"code":0,"msg":"\u83b7\u53d6\u6210\u529f\uff01","data":{"0":{"id":23,"activity_id":4,"field1":"field1","field2":"field2","field3":"field3","name":"name","branch_name":"branch_name","keshi_name":"keshi_name","city":"city","district":"district","sex":0,"telephone":"telephone","phone":"phone","is_save":0,"remark":"remark"},"activity_name":"\u4f1a\u8bae\u540d\u79f0"},"info":{"limit":"1","page_current":"1","page_sum":2}} ``` **9\. 导出某会议的所有签到记录 后台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/blog.activity/exportActRecord] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议记录id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | | | | ###### 接口示例 > 地址：[http://www.api.com/admin/blog.activity/exportActRecord] ``` 输出excle文件 ``` **10\. 获取管理员列表 后台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/user/index] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | search[name]| 否 | string| 模糊查询用户姓名字段| | search[status]| 否 | string|状态筛选 1：启用 0 禁用| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | | data| array| 会议信息数组 | | data[][id]| int | 用户ID | | data[][username]| string | 用户账号 | | data[][name]| string | 用户姓名 | | data[][remark]| string | 备注 | | data[][status] | string | 状态 1：启用 0 禁用 | | data[][create_at]| string | 创建时间| | data[][last_ip]| string | 上次登录IP| | data[][last_login_time]| datetime | 上次登录时间| | data[][login_times]| int | 登录次数| | page_info| array| 页数数组 | | page_info[limit]| int | 每页显示数 | | page_info[page_current]| int | 当前页码 | | page_info[page_sum]| int | 总共页数 | ###### 接口示例 > 地址：[http://www.api.com/admin/user/index?search[status]=1] ``` { "code": 0, "msg": "查询成功！", "count": 4, "info": { "limit": 10, "page_current": 1, "page_sum": 1 }, "data": [ { "id": 1, "username": "admin", "name": "123", "remark": "", "status": 1, "create_at": "2019-03-27 10:30:36", "last_ip": "127.0.0.1", "last_login_time": "2019-08-21 15:13:39", "login_times": 7 }, { "id": 2, "username": "nftest", "name": "", "remark": "南方网院所账号", "status": 1, "create_at": "2019-04-11 16:27:04", "last_ip": null, "last_login_time": null, "login_times": 0 } ] } ``` **11\. 添加管理员 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/user/add] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | name| 是 | string | 管理姓名 | | username| 是 | string| 管理员账号 | | password | 是 | string | 密码 | | password1 | 是 | string | 密码重复 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | | data| int| 添加成功则返回id | ###### 接口示例 > 地址：[http://www.api.com/admin/user/add] ``` { "code": 0, "msg": "账户添加成功！", "data": "" } ``` **12\. 修改管理员 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/user/edit] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | name| 是 | string | 管理姓名 | | username| 是 | string| 管理员账号 | | password | 是 | string | 密码 | | password1 | 是 | string | 密码重复 | | id | 是 | int | 管理员id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/user/edit] ``` { "code": 0, "msg": "管理员信息修改成功！", "data": "" } ``` **13\. 删除管理员** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/user/del] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 管理员id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/user/del?id=5] ``` { "code": 0, "msg": "删除成功！", "data": "" } ``` **14\. 禁用或启用管理员** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/admin/user/status] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | id| 是 | int | 会议id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/user/status?id=5] ``` { "code": 0, "msg": "禁用成功！", "data": "" } ``` **15\. 修改自己密码 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/user/edit_password] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | old_password| 是 | string| 旧密码 | | password | 是 | string | 新密码 | | password1 | 是 | string | 新密码重复 | | id | 是 | int | id | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/user/edit] ``` { "code": 0, "msg": "修改成功！", "data": "" } ``` **16\. 退出登录 后台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/login/out] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | ###### 接口示例 > 地址：[http://www.api.com/admin/login/out] ``` { "code": 0, "msg": "退出登录成功！", "data": "" } ``` **17\. 查看会议校验 前台** ###### 接口功能 > ###### URL > [http://www.api.com/admin/login/checkPassword] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | | vercode| 是 | string| 验证码 | | password | 是 | string | 密码 | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：错误 0：正常 | | msg | string | 结果提示 | | data[id]| string | 会议id | | data[field1]| string | 自定义字段1 | | data[field2]| string | 自定义字段2 | | data[field3] | string | 自定义字段3 | | data[is_job_show]| int | 是否显示职务 1是 0否| | data[content]| string | 会议内容| | data[name]| string | 会议名称| ###### 接口示例 > 地址：[http://www.api.com/admin/login/checkPassword] ``` {"code":0,"msg":"查询会议成功","data":{"id":4,"name":"会议名称","content":"会议内容4","is_job_show":1,"field1":"自定义内容","field2":"自定义内容2","field3":"自定义内容3"}} ``` **18\. 获取所有会议列表 前台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/api/index/getActList] ###### 支持格式 > JSON ###### HTTP请求方式 > GET ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| array| 会议信息数组 | | data[id]| int | 用户ID | | data[activity_name]| string | 会议名称| ###### 接口示例 > 地址：[http://www.api.com/admin/login/checkPassword] ``` {"code":0,"msg":"\u67e5\u8be2\u6210\u529f\uff01","count":2,"data":[{"id":6,"name":"\u4f1a\u8bae\u540d\u79f0"},{"id":4,"name":"\u4f1a\u8bae\u540d\u79f0"}]} ``` **19\. 增加会议签到 前台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/api/index/addRecord] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | |activity_id|是| string | 所属会议id | | field1| string |是| 自定义字段1 | |field2| string |是 | 自定义字段2 | | field3 |是| string | 自定义字段3 | | name|是| string | 姓名| |branch_name|是| string | 部门名称| | keshi_name|是| string | 科室名称| | city|是| string | 城市 市| | district|是| string | 城市 区| | sex|是| string | 性别 (1：男，2：女）| | telephone|是| string | 固话| | phone|是| string | 手机号码| | telephone|是| string | 固话| | is_save|是| int | 是否住宿 1是 0否| | remark|是| string | 备注| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| int| 成功返回记录id | ###### 接口示例 > 地址：[http://www.api.com/api/index/addRecord] ``` {"code":0,"msg":"\u63d0\u4ea4\u6210\u529f\uff01","data":"24"} ``` **20\. 修改会议签到 前台** ###### 接口功能 > 获取排名 ###### URL > [http://www.api.com/api/index/editRecord] ###### 支持格式 > JSON ###### HTTP请求方式 > POST ###### 请求参数 | 参数 | 必选 | 类型 | 说明 | | ---- | ---- | ---- | ---- | |activity_id|是| string | 所属会议id | | field1| string |是| 自定义字段1 | |field2| string |是 | 自定义字段2 | | field3 |是| string | 自定义字段3 | | name|是| string | 姓名| |branch_name|是| string | 部门名称| | keshi_name|是| string | 科室名称| | city|是| string | 城市 市| | district|是| string | 城市 区| | sex|是| string | 性别 (1：男，2：女）| | telephone|是| string | 固话| | phone|是| string | 手机号码| | telephone|是| string | 固话| | is_save|是| int | 是否住宿 1是 0否| | remark|是| string | 备注| | id|是| int | 记录id| ###### 返回字段 | 返回字段 | 字段类型 | 说明 | | -------- | -------- | ------------------------------ | | code | int | 返回结果状态。 1：正常 0：错误 | | msg | string | 结果提示 | | data| int| | ###### 接口示例 > 地址：[http://www.api.com/api/index/editRecord] ``` {"code":0,"msg":"\u63d0\u4ea4\u6210\u529f\uff01","data":"1"} ```