学生信息管理系统系统_学院管理_查询新增或修改删除标准接口需求接口V1.0
4.4新增学院信息接口标准
请求方法:post
4.4.1新增单个学院信息
项目 | 描述 | |
接口说明 | 新增单个学院信息。 | |
输入参数 | /api/departments/
| |
参数格式 | json格式 | |
参数示例 | { "data": [ { "dep_id":"T01", "dep_name":"Test学院", "master_name":"Test-Master", "slogan":"Here is Slogan" } ] } | |
新增成功返回结果 | URL成功 返回 数据 结构 | { "already_exist": { "results": [], "count": 0 }, "create_success": { "results": [ { "dep_id": "T02", "dep_name": "Java学院", "master_name": "Java-Master", "slogan": "java" } ], "count": 1 } } |
新增失败id已存在- | URL失败 返回 数据 结构 | { "already_exist": { "results": [ { "dep_id": "T01", "dep_name": "Test学院", "master_name": "Test-Master", "slogan": "Here is Slogan" } ], "count": 1 }, "create_success": { "results": [], "count": 0 } } |
新增失败json格式错误: | URL失败 返回 数据 结构 | { "status_code": 400, "detail": "请求体参数格式错误。" } |
4.4.2新增多个学院信息
项目 | 描述 | |
接口说明 | 新增多个学院信息。 | |
输入参数 | /api/departments/
| |
参数格式 | json格式 | |
参数示例 | 请求数据报文json(可新增多条,之间用,隔开),2个如下: { "data": [ { "dep_id": "T01", "dep_name": "Test学院", "master_name": "Test-Master", "slogan": "Here is Test Slogan" }, { "dep_id": "T02", "dep_name": "Java学院", "master_name": "Java-Master", "slogan": "Here is Java Slogan" }, ] } | |
新增成功返回结果 | URL成功 返回 数据 结构 | { "already_exist": { "results": [], "count": 0 }, "create_success": { "results": [ { "dep_id": "T02", "dep_name": "Java学院", "master_name": "Java-Master", "slogan": "java" } ], "count": 1 } } |
新增失败id已存在- | URL失败 返回 数据 结构 | { "already_exist": { "results": [ { "dep_id": "T01", "dep_name": "Test学院", "master_name": "Test-Master", "slogan": "Here is Slogan" } ], "count": 1 }, "create_success": { "results": [], "count": 0 } } |
新增失败json格式错误: | URL失败 返回 数据 结构 | { "status_code": 400, "detail": "请求体参数格式错误。" } |
4.5修改学院信息接口标准
请求方法:put
4.5.1修改指定的学院信息
项目 | 描述 | |
接口说明 | 管理者用来修改指定的学院信息。 | |
特殊说明 | T03为学院ID,学院ID与数据中的dep_id的值必须一致 | |
输入参数 | /api/departments/T03/ | |
参数格式 | json | |
参数示例 | { "data": [ { "dep_id": "T03", "dep_name": "C++/学院", "master_name": "C++-Master", "slogan": "Here is Slogan" } ] } | |
|