API 接口文档

学生查询系统接口说明

隐私保护说明：接口返回的敏感信息已进行脱敏处理：
GET /api/students/search
查询学生个人信息（通过学号和姓名）
请求参数（Query Parameters）
  • student_id string 必填 精确匹配 学号
  • name string 必填 精确匹配 姓名

注：所有参数均为必填，且为精确匹配

请求示例
GET /api/students/search?student_id=245102030147&name=张三
成功响应示例
"code": 200, "message": "success", "data": [ { "student_id": "24510203****", "name": "张三", "class_name": "计算机一班", "grade": "2024级", "major": "计算机科学与技术", "department": "信息学院", "gender": "男", "phone": "157****0001", "email": "24510203****@gznylg.edu.cn_test", "status": 1, "motto": "成功不是将来才有的，而是从决定去做的那一刻起，持续累积而成。 - 俞敏洪 - 演讲" } ], "count": 1
失败响应示例
"code": 400, "message": "学号为必填参数" "code": 400, "message": "姓名为必填参数" "code": 404, "message": "未找到匹配的学生信息"
POST /api/students/class
查询班级学生列表（通过学号、姓名和班级名称）
请求体（JSON）
  • student_id string 必填 精确匹配 学号
  • name string 必填 精确匹配 姓名
  • class_name string 必填 精确匹配 班级名称

注：所有参数均为必填，且为精确匹配。先验证学生信息，再返回整个班级列表

请求示例
POST /api/students/class Content-Type: application/json { "student_id": "245102030147", "name": "张三", "class_name": "计算机一班" }
成功响应示例
"code": 200, "message": "success", "data": [ { "student_id": "24510203****", "name": "张三", "class_name": "计算机一班", "grade": "2024级", "major": "计算机科学与技术", "department": "信息学院", "gender": "男", "phone": "157****0001", "email": "24510203****@gznylg.edu.cn_test", "status": 1 }, { "student_id": "24510203****", "name": "李四", "class_name": "计算机一班", "grade": "2024级", "major": "计算机科学与技术", "department": "信息学院", "gender": "女", "phone": "139****0002", "email": "24510203****@gznylg.edu.cn_test", "status": 1 } ], "count": 2, "class_name": "计算机一班"
失败响应示例
"code": 400, "message": "请提供请求体" "code": 400, "message": "学号为必填参数" "code": 400, "message": "姓名为必填参数" "code": 400, "message": "班级名称为必填参数" "code": 404, "message": "未找到匹配的学生信息"
POST /api/students/class
响应字段说明
data 数组中每个对象的字段
  • student_id string 学号（已脱敏）
  • name string 姓名
  • class_name string 班级名称
  • grade string 年级
  • major string 专业
  • department string 学院
  • gender string 性别
  • phone string 联系电话（已脱敏）
  • email string 邮箱（已脱敏）
  • status integer 状态：1-在读，0-毕业
  • motto string 随机名人名言（格式：名言 - 作者 - 出处），仅个人查询接口返回，如未配置则返回空字符串

学生查询系统 API Documentation