---
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|