1ll大学学生信息管理系统系统_学院管理_查询新增或修改删除标准接口_

目录

修订版本

[1. 目的](#1. 目的)

[2. 阅读人员](#2. 阅读人员)

[3. 参考文档](#3. 参考文档)

ll大学学生信息管理系统系统_学院管理_查询新增或修改删除标准接口

[4.1 接口概述](#4.1 接口概述)

[4.2 接口名称](#4.2 接口名称)

4.3查询学院信息接口标准

4.4新增学院信息接口标准

4.5修改学院信息接口标准


学生信息管理系统系统_学院管理_查询新增或修改删除标准接口需求接口V1.0

修订版本

|---------|-------------|--------|------------|
| Ver No. | Description | Author | Date |
| 版本编号 | 描述 | 作者 | 日期 |
| V1.0 | 编制 | ahui | 2022-07-19 |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |
| | | | |

1. 目的

本文档是根据《中国高校联盟各个业务系统接口定义规范》要求设计的接口规范模版,用于指导各高校各个业务系统间接口的实施。

2. 阅读人员

Ø 业务 需求

Ø 服务消费方的开发商

Ø 系统维护员

Ø 各业务系统接口负责人以及接口开发/维护/测试人员

3. 参考文档

《01: 中国高校联盟 系统接口定义规范》

ll大学学生信息管理系统系统_学院管理_查询新增或修改删除标准接口

4.1 接口概述

管理系统查询新增或修改删除学院信息需求的任务状态。

4 .2 接口名称

大学学生信息管理系统系统_学院管理_查询新增或修改删除标准接口

4.3查询学院信息 接口标准

根地址:http://127.0.0.1:8000

请求方法:get

4.3.1 查询 全部学院信息

|----------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 项目 | 描述 ||
| 接口说明 | 查询全部的学院信息。 ||
| 输入参数 | /api/departments/ ||
| 返回结果 | URL 返回 数据 结构 | HTTP 200 OKAllow: GET, POST, DELETEContent-Type: application/jsonVary: Accept { "count": 50, "next": "http://127.0.0.1:8000/api/departments/?page=2", "previous": null, "results": [ { "dep_id": "T01", "dep_name": "Python学院", "master_name": "王院长", "slogan": "简洁" }, { "dep_id": "ghi", "dep_name": "??", "master_name": "Name1", "slogan": "hello" }, { "dep_id": "gkl", "dep_name": "java", "master_name": "Name1", "slogan": "hello" }, 。。。 ]} |
| | ||

4.3.2查询指定学院信息

|----------|---|---|
| 项目 | 描述 ||
| 接口说明 | 管理者用来查询指定的学院信息。 ||
| 输入参数 | /api/departments/T01/ ||

学生信息管理系统系统_学院管理_查询新增或修改删除标准接口需求接口 V1.0

4.4新增学院信息 接口标准

根地址:http://127.0.0.1:8000

请求方法: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修改学院信息 接口标准

根地址:http://127.0.0.1:8000

请求方法: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" } ] } ||


以下是我收集到的比较好的学习教程资源,虽然不是什么很值钱的东西,如果你刚好需要,可以评论区,留言【777】直接拿走就好了

各位想获取资料的朋友请 点赞 + 评论 + 收藏 ,三连!

三连之后我会在评论区挨个私信发给你们~

相关推荐
StarPrayers.3 分钟前
旅行商问题(TSP)(2)(heuristics.py)(TSP 的两种贪心启发式算法实现)
前端·人工智能·python·算法·pycharm·启发式算法
qiuiuiu41310 分钟前
正点原子RK3568学习日志-编译第一个驱动程序helloworld
linux·c语言·开发语言·单片机
2351614 分钟前
【LeetCode】146. LRU 缓存
java·后端·算法·leetcode·链表·缓存·职场和发展
聪明的笨猪猪18 分钟前
Java Redis “运维”面试清单(含超通俗生活案例与深度理解)
java·经验分享·笔记·面试
木头左24 分钟前
波动率聚类现象对ETF网格密度配置的启示与应对策略
python
苏打水com1 小时前
JavaScript 面试题标准答案模板(对应前文核心考点)
javascript·面试
molong9311 小时前
Kotlin 内联函数、高阶函数、扩展函数
android·开发语言·kotlin
华仔AI智能体1 小时前
Qwen3(通义千问3)、OpenAI GPT-5、DeepSeek 3.2、豆包最新模型(Doubao 4.0)通用模型能力对比
人工智能·python·语言模型·agent·智能体
盼哥PyAI实验室1 小时前
踏上编程征程,与 Python 共舞
开发语言·python