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

2022-08-26 09:25发布

4.4新增班级信息接口标准

根地址:http://127.0.0.1:8000

请求方法:post

4.4.1新增单个班级信息

项目

描述

接口说明

新增单个班级信息。

输入参数

/api/departments/T02/classes/

参数格式

json格式

参数示例

             {

                "data": [

                            {

                                "cls_id": "2018T01C015",

                                "cls_name": "2018Test学院C015",

                                "master_name": "Master15",

                                "slogan": "slogan15"

                            }

                        ]

              }

新增成功返回结果

URL成功

返回

数据

结构

        {

          "already_exist": {

            "results": [],

            "count": 0

          },

          "create_success": {

            "results": [

              {

               "cls_id": "2018T01C015",

               "cls_name": "2018Test学院C015",

               "master_name": "Master15",

              "slogan": "slogan15"

              }

            ],

            "count": 1

          }

        }

新增失败id已存在-  

URL失败

返回

数据

结构

{

          "already_exist": {

            "results": [

                        {

               "cls_id": "2018T01C015",

               "cls_name": "2018Test学院C015",

               "master_name": "Master15",

              "slogan": "slogan15"

              }

 

            ],

            "count": 1

          },

          "create_success": {

            "results": [],

            "count": 0

          }

        }

新增失败json格式错误:

URL失败

返回

数据

结构

     {

        "status_code": 400,

        "detail": "请求体参数格式错误。"

        }

 

4.4.2新增多个班级信息

项目

描述

接口说明

新增多个班级信息。

输入参数

/api/departments/

 

参数格式

json格式

参数示例

请求数据报文json(可新增多条,之间用,隔开),2个如下:

          {

                "data": [

                         {

                           "cls_id": "2018T01C015",

                           "cls_name": "2018Test学院C015",

                           "master_name": "Master15",

                            "slogan": "slogan15"

                          },

                        {

                          "cls_id": "2018T01C015",

                           "cls_name": "2018Test学院C015",

                           "master_name": "Master15",

                            "slogan": "slogan15"

                        },  

                  ]

            }

新增成功返回结果

URL成功

返回

数据

结构

        {

          "already_exist": {

            "results": [],

            "count": 0

          },

          "create_success": {

            "results": [

              {

                 "cls_id": "2018T01C015",

                           "cls_name": "2018Test学院C015",

                           "master_name": "Master15",

                            "slogan": "slogan15"

            }

            ],

            "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修改指定的班级信息

项目

描述

接口说明

管理者用来修改指定的班级信息

特殊说明

T01:学院ID;2017T01C05:为班级ID

输入参数

//api/departments/T01/classes/2017T01C05/

参数格式

json

参数示例

            {

               "data": [&