vitesse-yitisheng-web/docs/成绩修改api.md

title	language_tabs	toc_footers	includes	search	code_clipboard	highlight_theme	headingLevel	generator
艺考招生管理系统 API	shell Shell http HTTP javascript JavaScript ruby Ruby python Python php PHP java Java go Go			true	true	darkula	2	@tarslib/widdershins v4.0.30

艺考招生管理系统 API

提供用户认证、院校专业、历年招生、计算专业的管理接口

Base URLs:

Authentication

用户分数操作

POST 保存用户成绩

POST /user/score/save-score

Body 请求参数

{
  "cognitioPolyclinic": "文科",
  "subjectList": [
    "化学",
    "生物",
    "地理"
  ],
  "professionalCategory": "表演类",
  "professionalCategoryChildren": [
    "服装表演",
    "戏剧影视表演"
  ],
  "professionalCategoryChildrenScore": {
    "服装表演": 50,
    "戏剧影视表演": 10
  },
  "professionalScore": 250,
  "culturalScore": 500,
  "englishScore": 120,
  "chineseScore": 121,
  "province": "河南"
}

请求参数

名称	位置	类型	必选	说明
body	body	dto.SaveScoreRequest	是	none

返回示例

200 Response

{"code":200,"message":"success","data":{"id":"bdd80291-797e-451c-9bf0-c81705362dc9","type":"1","educationalLevel":"1","professionalCategory":"表演类","subjects":"化学,生物,地理","professionalScore":250,"culturalScore":500,"ranking":0,"createBy":"1779515858733772802","createTime":"0001-01-01T00:00:00Z","updateBy":"","updateTime":"0001-01-01T00:00:00Z","state":"1","province":"河南","cognitioPolyclinic":"文科","batch":"","englishScore":120,"chineseScore":121,"yybysy":0,"yybyqy":0,"yyjy":0,"xjysdy":0,"xjysby":10,"fzby":50,"professionalCategoryChildren":"服装表演,戏剧影视表演","kbdNum":0,"nlqNum":0,"kcjNum":0,"jwtNum":0,"calculationTableName":""}}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	OK	common.Response

GET 获取当前用户的当前分数

GET /user/score

返回示例

200 Response

{"code":200,"message":"success","data":{"id":"2000794240905117697","type":"2","educationalLevel":"1","cognitioPolyclinic":"文科","subjectList":["政治","化学"],"professionalCategory":"美术与设计类","professionalCategoryChildren":[],"professionalCategoryChildrenScore":{},"professionalScore":234,"culturalScore":500,"englishScore":1,"chineseScore":1,"province":"河南","state":"1"}}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	OK	Inline

返回数据结构

状态码 200

名称	类型	必选	约束	中文名	说明
» code	integer	true	none		none
» message	string	true	none		none
» data	object	true	none		none
»» id	string	true	none		none
»» type	string	true	none		none
»» educationalLevel	string	true	none	1-本科,2-专科	none
»» cognitioPolyclinic	string	true	none	文理分班(文科/理科)	none
»» subjectList	[string]	true	none	专业选课	none
»» professionalCategory	string	true	none	专业类别(美术与设计类、音乐类...)	none
»» professionalCategoryChildren	[string]	true	none	专业子级列表	none
»» professionalCategoryChildrenScore	object	true	none	专业子级成绩	none
»» professionalScore	integer	true	none	统考成绩	none
»» culturalScore	integer	true	none	文化成绩	none
»» englishScore	integer	true	none	英语成绩	none
»» chineseScore	integer	true	none	语文成绩	none
»» province	string	true	none	地区	none
»» state	string	true	none	状态(1-启用,2-关闭)	none

数据模型

common.Response

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

属性

名称	类型	必选	约束	中文名	说明
code	integer	false	none		none
data	any	false	none		none
message	string	false	none		none

dto.SaveScoreRequest

{
  "ChineseScore": 0,
  "CognitioPolyclinic": "string",
  "CulturalScore": 0,
  "EnglishScore": 0,
  "ProfessionalCategory": "string",
  "ProfessionalCategoryChildren": [
    "string"
  ],
  "ProfessionalCategoryChildrenScore": {
    "property1": 0,
    "property2": 0
  },
  "ProfessionalScore": 0,
  "Province": "string",
  "SubjectList": [
    "string"
  ],
  "createBy": "string"
}

属性

名称	类型	必选	约束	中文名	说明
ChineseScore	number	true	none		none
CognitioPolyclinic	string	true	none		none
CulturalScore	number	true	none		none
EnglishScore	number	true	none		none
ProfessionalCategory	string	true	none		none
ProfessionalCategoryChildren	[string]	true	none		none
ProfessionalCategoryChildrenScore	object	true	none		none
» additionalProperties	number(float64)	false	none		none
ProfessionalScore	number	true	none		none
Province	string	true	none		none
SubjectList	[string]	true	none		none
createBy	string	false	none		none