添加学生 - flask后端

此接口用于添加学生（开户），需要管理员有添加权限，可接受的输入
"birth_date": 生日，以xxxx-xx-xx格式输入
"card_status": "正常",默认正常，有正常，挂失，锁定，销毁，余额错误锁定五个状态，其中余额错误锁定不能手动设置
"card_valid_period": "2027-02-27",有效日期，默认是开户日加上三年
"discount_rate": 100,折扣率，默认100，整数百分比形式
"id_card_number": "",身份证号
"identity_type": "身份证",默认身份证
"name": "张三",名字（必填）
"student_id": "202401161629"，学号（必填）
"card_number": "20240116162901224934517887502608",从硬件开卡获取的卡号(必填),
"classes"：教室名称，该学生要添加到哪个教室下（必填）
"grade"：年级名称，该学生要添加到哪个年级下（必填）
"school"：学校名称，该学生要添加到哪个学校下（root必填,非root只能添加本校,无需填写）
"remark":备注

请求参数

Cookie 参数

token

string

必需

示例值:

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VybmFtZSI6InJvb3QiLCJleHAiOjE3MTg5OTEyOTR9.DOsBfYOucVT4MsORsg1XqaJMfa6vN3d7BlZBnJdInwo

Body 参数application/json

object {0}

示例

{
    "name": "张三",
    "classes": "1班",
    "grade": "初中二年级",
    "school": "北大",
    "student_id": "202401161629012",
    "card_number": "20240116162901224934517887502608",
    "identity_type": "",
    "id_card_number": "",
    "discount_rate":100,
    "card_status": "正常",
    "remark": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

必需

account_balance

integer

必需

birth_date

null

必需

card_balance

integer

必需

card_number

string

必需

card_status

string

必需

card_status_value

string

必需

card_valid_period

string

必需

circle_count

integer

必需

classes

string

必需

consumption_count

integer

必需

discount_rate

integer

必需

grade

string

必需

string

必需

id_card_number

string

必需

identity_type

string

必需

name

string

必需

recharge_count

integer

必需

school

string

必需

student_id

string

必需

message

string

必需

status

string

必需

示例

成功示例成功示例

{
    "data": {
        "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"
    },
    "message": "添加成功",
    "status": "success"
}

🟠400请求有误

🔴500数据库出错

🟠403拒绝访问

🟢288学号重复