【无标题】


title: 专业综合实践与训练 v1.0.0
language_tabs:

  • shell: Shell
  • http: HTTP
  • javascript: JavaScript
  • ruby: Ruby
  • python: Python
  • php: PHP
  • java: Java
  • go: Go
    toc_footers: []
    includes: []
    search: true
    code_clipboard: true
    highlight_theme: darkula
    headingLevel: 2
    generator: “@tarslib/widdershins v4.0.17”

专业综合实践与训练

v1.0.0

Base URLs:

学员信息管理

GET 列表查询学员信息

GET /student/stu-list

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 24,
      "userId": 24,
      "name": "学员1",
      "age": 20,
      "sex": "女",
      "idKind": "居民身份证",
      "idCard": 13344,
      "phone": "13744569876",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 100,
      "planB": 100,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": 1
    },
    {
      "id": 25,
      "userId": 25,
      "name": "学员2",
      "age": 21,
      "sex": "女",
      "idKind": null,
      "idCard": 13345,
      "phone": "15433427789",
      "region": "汉族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": null
    },
    {
      "id": 26,
      "userId": 26,
      "name": "学员3",
      "age": 18,
      "sex": "女",
      "idKind": null,
      "idCard": 13346,
      "phone": "17745662311",
      "region": "汉族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": null
    },
    {
      "id": 29,
      "userId": 29,
      "name": "学员五",
      "age": 23,
      "sex": "女",
      "idKind": null,
      "idCard": 13347,
      "phone": null,
      "region": "回族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 2,
      "typeId": null
    },
    {
      "id": 32,
      "userId": 32,
      "name": "张三",
      "age": 18,
      "sex": "男",
      "idKind": "居民身份证",
      "idCard": 1234567890,
      "phone": "121321435",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 100,
      "typeId": 6
    }
  ]
}

401 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 修改学员信息

POST /student/update

Body 请求参数

{
  "age": 0,
  "entry": 0,
  "id": 0,
  "idCard": 0,
  "idKind": "string",
  "instructorId": 0,
  "name": "string",
  "phone": "string",
  "planA": 0,
  "planB": 0,
  "planC": 0,
  "planD": 0,
  "region": "string",
  "sex": "string",
  "time": "2019-08-24T14:15:22Z",
  "typeId": 0,
  "userId": 0
}

请求参数

名称位置类型必选说明
bodybodyStudentnone

返回示例

200 Response

{
  "code": 0,
  "data": {
    "age": 0,
    "entry": 0,
    "id": 0,
    "idCard": 0,
    "idKind": "string",
    "instructorId": 0,
    "name": "string",
    "phone": "string",
    "planA": 0,
    "planB": 0,
    "planC": 0,
    "planD": 0,
    "region": "string",
    "sex": "string",
    "time": "2019-08-24T14:15:22Z",
    "typeId": 0,
    "userId": 0
  },
  "message": "string"
}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

GET 通过教练id列表查询学员信息

GET /student/stu-list-by-instructorid/{id}

请求参数

名称位置类型必选说明
idpathintegerid

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 24,
      "userId": 24,
      "name": "学员1",
      "age": 20,
      "sex": "女",
      "idKind": "居民身份证",
      "idCard": 13344,
      "phone": "13744569876",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 100,
      "planB": 100,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": 1
    },
    {
      "id": 25,
      "userId": 25,
      "name": "学员2",
      "age": 21,
      "sex": "女",
      "idKind": null,
      "idCard": 13345,
      "phone": "15433427789",
      "region": "汉族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": null
    },
    {
      "id": 26,
      "userId": 26,
      "name": "学员3",
      "age": 18,
      "sex": "女",
      "idKind": null,
      "idCard": 13346,
      "phone": "17745662311",
      "region": "汉族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "typeId": null
    },
    {
      "id": 29,
      "userId": 29,
      "name": "学员五",
      "age": 23,
      "sex": "女",
      "idKind": null,
      "idCard": 13347,
      "phone": null,
      "region": "回族",
      "time": null,
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 2,
      "typeId": null
    },
    {
      "id": 32,
      "userId": 32,
      "name": "张三",
      "age": 18,
      "sex": "男",
      "idKind": "居民身份证",
      "idCard": 1234567890,
      "phone": "121321435",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 100,
      "typeId": 6
    }
  ]
}

401 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 录入考试成绩

POST /student/getplan

Body 请求参数

{
  "id": 0,
  "plan": 0
}

请求参数

名称位置类型必选说明
bodybodyPlannone

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": 26,
    "userId": 26,
    "name": "学员3",
    "age": 18,
    "sex": "女",
    "idKind": null,
    "idCard": 13346,
    "phone": "17745662311",
    "region": "汉族",
    "time": null,
    "planA": 80,
    "planB": 0,
    "planC": 0,
    "planD": 0,
    "instructorId": 23,
    "entry": 0,
    "typeId": null
  }
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

GET 通过id查找报名资格

GET /student/get-entry/{userId}

请求参数

名称位置类型必选说明
userIdpathintegeruserId

返回示例

200 Response

{
  "code": 0,
  "data": 0,
  "message": "string"
}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 教练打卡信息

POST /student/updateentry/{userId}/{time}

请求参数

名称位置类型必选说明
userIdpathintegeruserId
timepathintegertime

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": 29,
    "userId": 29,
    "name": "学员五",
    "age": 23,
    "sex": "女",
    "idKind": null,
    "idCard": 13347,
    "phone": null,
    "region": "回族",
    "time": null,
    "planA": 0,
    "planB": 0,
    "planC": 0,
    "planD": 0,
    "instructorId": 23,
    "entry": 2,
    "typeId": null
  }
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

GET 列表查询学员信息包括教练名称和驾校名称

GET /student/stu-list-and-else

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 24,
      "name": null,
      "age": 20,
      "sex": "女",
      "typename": "大型客车 A1",
      "idKind": "居民身份证",
      "idCard": 13344,
      "phone": "13744569876",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 100,
      "planB": 100,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 0,
      "instructorName": "王教练",
      "schoolName": "双百驾校"
    },
    {
      "id": 32,
      "name": null,
      "age": 18,
      "sex": "男",
      "typename": "小型汽车 C1",
      "idKind": "居民身份证",
      "idCard": 1234567890,
      "phone": "121321435",
      "region": "汉族",
      "time": "2023-07-07 00:00:00",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "instructorId": 23,
      "entry": 100,
      "instructorName": "王教练",
      "schoolName": "双百驾校"
    }
  ]
}

401 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

GET 模糊查询全部学员

GET /student/getStuListByName/{keyword}

请求参数

名称位置类型必选说明
keywordpathstringkeyword

返回示例

200 Response

{
  "code": 0,
  "data": [
    {
      "age": 0,
      "entry": 0,
      "id": 0,
      "idCard": 0,
      "idKind": "string",
      "instructorId": 0,
      "name": "string",
      "phone": "string",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "region": "string",
      "sex": "string",
      "time": "2019-08-24T14:15:22Z",
      "typeId": 0,
      "userId": 0
    }
  ],
  "message": "string"
}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

GET 模糊查询教练学员

GET /student/getStuByName/{keyword}/{insId}

请求参数

名称位置类型必选说明
keywordpathstringkeyword
insIdpathintegerinsId

返回示例

200 Response

{
  "code": 0,
  "data": [
    {
      "age": 0,
      "entry": 0,
      "id": 0,
      "idCard": 0,
      "idKind": "string",
      "instructorId": 0,
      "name": "string",
      "phone": "string",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "region": "string",
      "sex": "string",
      "time": "2019-08-24T14:15:22Z",
      "typeId": 0,
      "userId": 0
    }
  ],
  "message": "string"
}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 通过id修改学员教练id和驾校id和身份证号和考试类型

POST /student/updateid

Body 请求参数

{
  "idCard": 0,
  "idKind": "string",
  "instructorId": 0,
  "schoolId": 0,
  "typeId": 0,
  "userId": 0
}

请求参数

名称位置类型必选说明
bodybodyStunone

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": 29,
    "userId": 29,
    "name": "学员五",
    "age": 23,
    "sex": "女",
    "idKind": "居民身份证",
    "idCard": 4306822220292828000,
    "phone": null,
    "region": "回族",
    "time": null,
    "planA": 0,
    "planB": 0,
    "planC": 0,
    "planD": 0,
    "instructorId": 33,
    "entry": 2,
    "typeId": 6
  }
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

用户信息管理

POST 登录以后返回id

POST /user/login

Body 请求参数

{
  "password": "string",
  "username": "string"
}

请求参数

名称位置类型必选说明
bodybodyUserLoginParamnone

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "userInfo": {
      "id": 34,
      "username": "小杜",
      "password": null,
      "email": "554959937@qq.com",
      "icon": null
    },
    "userRole": {
      "id": 3,
      "driveschoolId": 1,
      "name": "学员1",
      "driveschoolName": "双百驾校",
      "description": "科目一"
    }
  }
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 用户注册

POST /user/register

Body 请求参数

{
  "authCode": "string",
  "email": "string",
  "password": "string",
  "username": "string"
}

请求参数

名称位置类型必选说明
bodybodyUserRegisterParamnone

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": 34,
    "username": "小杜",
    "password": "$2a$10$7waPWMAZLfazcwUQjDXnsOeuHRvX5AYAqzctQOhDfjGOkuOiJneNK",
    "email": "554959937@qq.com",
    "icon": null
  }
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKInline
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 上传用户头像

POST /user/upload/icon/{userId}

Body 请求参数

file: string

请求参数

名称位置类型必选说明
userIdpathintegeruserId
bodybodyobjectnone
» filebodystring(binary)file

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": "e35b039a-2c8f-4104-9cb3-36dbdbb1c511.jpg"
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKCommonResult
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

邮件发送管理

GET 发送邮箱验证码

GET /mail/send/{email}

请求参数

名称位置类型必选说明
emailpathstringnone

返回示例

成功

{
  "code": 200,
  "message": "操作成功",
  "data": null
}

返回结果

状态码状态码含义说明数据模型
200OK成功CommonResult

角色信息管理

POST 申请账号角色

POST /role/apply/{userId}/{driveschoolId}/{roleId}

请求参数

名称位置类型必选说明
userIdpathintegeruserId
driveschoolIdpathintegerdriveschoolId
roleIdpathintegerroleId

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": 1
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKCommonResult
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

POST 审核角色申请

POST /role/audit/{applyId}/{passed}

请求参数

名称位置类型必选说明
applyIdpathintegerapplyId
passedpathintegerpassed

返回示例

OK

{
  "code": 200,
  "message": "操作成功",
  "data": 1
}

201 Response

{}

返回结果

状态码状态码含义说明数据模型
200OKOKCommonResult
201CreatedCreatedInline
401UnauthorizedUnauthorizedInline
403ForbiddenForbiddenInline
404Not FoundNot FoundInline

返回数据结构

数据模型

Stu




{
  "idCard": 0,
  "idKind": "string",
  "instructorId": 0,
  "schoolId": 0,
  "typeId": 0,
  "userId": 0
}

属性

名称类型必选约束中文名说明
idCardinteger(int64)falsenonenone
idKindstringfalsenonenone
instructorIdinteger(int64)falsenonenone
schoolIdinteger(int64)falsenonenone
typeIdinteger(int64)falsenonenone
userIdinteger(int64)falsenonenone

CommonResult«List«StudentAndElse»»




{
  "code": 0,
  "data": [
    {
      "age": 0,
      "entry": 0,
      "id": 0,
      "idCard": 0,
      "idKind": "string",
      "instructorId": 0,
      "instructorName": "string",
      "name": "string",
      "phone": "string",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "region": "string",
      "schoolName": "string",
      "sex": "string",
      "time": "2019-08-24T14:15:22Z",
      "typename": "string"
    }
  ],
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
data[StudentAndElse]falsenonenone
messagestringfalsenonenone

StudentAndElse




{
  "age": 0,
  "entry": 0,
  "id": 0,
  "idCard": 0,
  "idKind": "string",
  "instructorId": 0,
  "instructorName": "string",
  "name": "string",
  "phone": "string",
  "planA": 0,
  "planB": 0,
  "planC": 0,
  "planD": 0,
  "region": "string",
  "schoolName": "string",
  "sex": "string",
  "time": "2019-08-24T14:15:22Z",
  "typename": "string"
}

属性

名称类型必选约束中文名说明
ageinteger(int32)falsenone年龄
entryinteger(int32)falsenone练习进度
idinteger(int64)falsenonenone
idCardinteger(int64)falsenone证件号码
idKindstringfalsenone证件类型(居民身份证、护照或港澳通行证)
instructorIdinteger(int64)falsenone教练id
instructorNamestringfalsenonenone
namestringfalsenone姓名
phonestringfalsenone手机号
planAinteger(int32)falsenone科一成绩
planBinteger(int32)falsenone科二成绩
planCinteger(int32)falsenone科三成绩
planDinteger(int32)falsenone科四成绩
regionstringfalsenone省份
schoolNamestringfalsenonenone
sexstringfalsenone性别
timestring(date-time)falsenone完成训练时间(可预约五天后的考试)
typenamestringfalsenone学车类型

CommonResult«int»




{
  "code": 0,
  "data": 0,
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
datainteger(int32)falsenonenone
messagestringfalsenonenone

Plan




{
  "id": 0,
  "plan": 0
}

属性

名称类型必选约束中文名说明
idinteger(int64)falsenone学员id
planinteger(int32)truenone成绩

CommonResult




{
  "code": 0,
  "message": "string",
  "data": {}
}

属性

名称类型必选约束中文名说明
codeintegerfalsenone状态码
messagestringfalsenone提示信息
dataobjectfalsenone数据封装




{}

属性

None

CommonResult«Student»




{
  "code": 0,
  "data": {
    "age": 0,
    "entry": 0,
    "id": 0,
    "idCard": 0,
    "idKind": "string",
    "instructorId": 0,
    "name": "string",
    "phone": "string",
    "planA": 0,
    "planB": 0,
    "planC": 0,
    "planD": 0,
    "region": "string",
    "sex": "string",
    "time": "2019-08-24T14:15:22Z",
    "typeId": 0,
    "userId": 0
  },
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
dataStudentfalsenonenone
messagestringfalsenonenone

Student




{
  "age": 0,
  "entry": 0,
  "id": 0,
  "idCard": 0,
  "idKind": "string",
  "instructorId": 0,
  "name": "string",
  "phone": "string",
  "planA": 0,
  "planB": 0,
  "planC": 0,
  "planD": 0,
  "region": "string",
  "sex": "string",
  "time": "2019-08-24T14:15:22Z",
  "typeId": 0,
  "userId": 0
}

属性

名称类型必选约束中文名说明
ageinteger(int32)falsenone年龄
entryinteger(int32)falsenone练习进度
idinteger(int64)falsenonenone
idCardinteger(int64)falsenone证件号码
idKindstringfalsenone证件类型(居民身份证、护照或港澳通行证)
instructorIdinteger(int64)falsenone教练id
namestringfalsenone姓名
phonestringfalsenone手机号
planAinteger(int32)falsenone科一成绩
planBinteger(int32)falsenone科二成绩
planCinteger(int32)falsenone科三成绩
planDinteger(int32)falsenone科四成绩
regionstringfalsenone省份
sexstringfalsenone性别
timestring(date-time)falsenone完成训练时间(可预约五天后的考试)
typeIdinteger(int64)falsenone学车类型
userIdinteger(int64)falsenone用户id

UserLoginParam




{
  "password": "string",
  "username": "string"
}

属性

名称类型必选约束中文名说明
passwordstringtruenone密码
usernamestringtruenone用户名

CommonResult«List«Student»»




{
  "code": 0,
  "data": [
    {
      "age": 0,
      "entry": 0,
      "id": 0,
      "idCard": 0,
      "idKind": "string",
      "instructorId": 0,
      "name": "string",
      "phone": "string",
      "planA": 0,
      "planB": 0,
      "planC": 0,
      "planD": 0,
      "region": "string",
      "sex": "string",
      "time": "2019-08-24T14:15:22Z",
      "typeId": 0,
      "userId": 0
    }
  ],
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
data[Student]falsenonenone
messagestringfalsenonenone

CommonResult«object»




{
  "code": 0,
  "data": {},
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
dataobjectfalsenonenone
messagestringfalsenonenone

UserRegisterParam




{
  "authCode": "string",
  "email": "string",
  "password": "string",
  "username": "string"
}

属性

名称类型必选约束中文名说明
authCodestringtruenone邮箱验证码
emailstringtruenone邮箱
passwordstringtruenone密码
usernamestringtruenone用户名

CommonResult«Map«string,object»»




{
  "code": 0,
  "data": {},
  "message": "string"
}

属性

名称类型必选约束中文名说明
codeinteger(int64)falsenonenone
dataobjectfalsenonenone
messagestringfalsenonenone
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值