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

2022-10-31 09:46发布

学生信息管理系统系统_学院管理_查询新增或修改删除标准接口需求接口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"

                        }

                  ]

            }