查询学生信息 - flask后端

此接口用于查询学生，需要管理员有查询权限
不传条件时默认查询所有学生，非root查询本校学生，以下参数均可用作查询条件传入
"account_balance": 0,
"birth_date": null,
"card_balance": 0,
"card_number": "20240116162921376969613570096488",
"card_status": "正常",
"card_valid_period": "2027-02-27",
"circle_count": 0,
"classes": "1班",
"consumption_count": 0,
"discount_rate": 100,
"grade": "初中一年级",
"id": "26491683-e439-4c24-8b78-7381c23c8194",
"id_card_number": "",
"identity_type": "身份证",
"name": "张三",
"recharge_count": 0,
"school": "北大",
"student_id": "202401161629"

请求参数

Query 参数

page

string

可选

pageSize

string

可选

school

string

可选

示例值:

北大1

grade

string

可选

示例值:

初中一年级

classes

string

可选

示例值:

1班

card_status

string

可选

示例值:

正常

等等

string

可选

Cookie 参数

token

string

可选

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InJvb3QxIiwiZXhwIjoxNzE4Mzg1OTA4fQ.WG9uG7lBLEw6e7u3SbQ0p9oBiTUhofXk-Z90pJqJPk0

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

必需

items

array [object {19}]

必需

page

integer

必需

pageSize

integer

必需

total

integer

必需

message

string

必需

status

string

必需

示例

{
  "data": {
    "items": [
      {
        "account_balance": 0.0,
        "birth_date": null,
        "card_balance": 0.0,
        "card_number": "20240116162921376969613570096488",
        "card_status": "正常",
        "card_status_value": "00000000000000000000000000000000",
        "card_valid_period": "2027-02-27",
        "circle_count": 0,
        "classes": "1班",
        "consumption_count": 0,
        "discount_rate": 100,
        "grade": "初中一年级",
        "id": "26491683-e439-4c24-8b78-7381c23c8194",
        "id_card_number": "",
        "identity_type": "身份证",
        "name": "张三",
        "recharge_count": 0,
        "school": "北大",
        "student_id": "202401161629"
      }
    ],
    "page": 1,
    "pageSize": 10,
    "total": 1
  },
  "message": "查询成功",
  "status": "成功"
}

🟠400请求有误

🟠404资源错误

🔴500数据库出错

🟠403拒绝访问