199 lines
5.4 KiB
Markdown
199 lines
5.4 KiB
Markdown
---
|
|
title: 艺考招生管理系统 API
|
|
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.30"
|
|
|
|
---
|
|
|
|
# 艺考招生管理系统 API
|
|
|
|
提供用户认证、院校专业、历年招生、计算专业的管理接口
|
|
|
|
Base URLs:
|
|
|
|
# Authentication
|
|
|
|
# 用户分数操作
|
|
|
|
## POST 保存用户成绩
|
|
|
|
POST /user/score/save-score
|
|
|
|
> Body 请求参数
|
|
|
|
```json
|
|
{
|
|
"cognitioPolyclinic": "文科",
|
|
"subjectList": [
|
|
"化学",
|
|
"生物",
|
|
"地理"
|
|
],
|
|
"professionalCategory": "表演类",
|
|
"professionalCategoryChildren": [
|
|
"服装表演",
|
|
"戏剧影视表演"
|
|
],
|
|
"professionalCategoryChildrenScore": {
|
|
"服装表演": 50,
|
|
"戏剧影视表演": 10
|
|
},
|
|
"professionalScore": 250,
|
|
"culturalScore": 500,
|
|
"englishScore": 120,
|
|
"chineseScore": 121,
|
|
"province": "河南"
|
|
}
|
|
```
|
|
|
|
### 请求参数
|
|
|
|
|名称|位置|类型|必选|说明|
|
|
|---|---|---|---|---|
|
|
|body|body|[dto.SaveScoreRequest](#schemadto.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](https://tools.ietf.org/html/rfc7231#section-6.3.1)|OK|[common.Response](#schemacommon.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](https://tools.ietf.org/html/rfc7231#section-6.3.1)|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|
|
|
|
|
# 数据模型
|
|
|
|
<h2 id="tocS_common.Response">common.Response</h2>
|
|
|
|
<a id="schemacommon.response"></a>
|
|
<a id="schema_common.Response"></a>
|
|
<a id="tocScommon.response"></a>
|
|
<a id="tocscommon.response"></a>
|
|
|
|
```json
|
|
{
|
|
"code": 0,
|
|
"data": null,
|
|
"message": "string"
|
|
}
|
|
|
|
```
|
|
|
|
### 属性
|
|
|
|
|名称|类型|必选|约束|中文名|说明|
|
|
|---|---|---|---|---|---|
|
|
|code|integer|false|none||none|
|
|
|data|any|false|none||none|
|
|
|message|string|false|none||none|
|
|
|
|
<h2 id="tocS_dto.SaveScoreRequest">dto.SaveScoreRequest</h2>
|
|
|
|
<a id="schemadto.savescorerequest"></a>
|
|
<a id="schema_dto.SaveScoreRequest"></a>
|
|
<a id="tocSdto.savescorerequest"></a>
|
|
<a id="tocsdto.savescorerequest"></a>
|
|
|
|
```json
|
|
{
|
|
"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|
|
|
|