仿中招管理系统API文档

1. 1. 默认模块
2. 2. Authentication
3. 3. Default
   1. 3.1. GET 初始化管理员账号
      1. 3.1.1. 返回结果
      2. 3.1.2. 返回数据结构
   2. 3.2. POST 用户登录
      1. 3.2.1. 请求参数
      2. 3.2.2. 返回结果
      3. 3.2.3. 返回数据结构
   3. 3.3. GET 获取某个配置
      1. 3.3.1. 请求参数
      2. 3.3.2. 返回结果
      3. 3.3.3. 返回数据结构
   4. 3.4. GET 获取当前登录用户信息
      1. 3.4.1. 请求参数
      2. 3.4.2. 返回结果
      3. 3.4.3. 返回数据结构
4. 4. 管理端
   1. 4.1. POST 添加学校
      1. 4.1.1. 请求参数
      2. 4.1.2. 返回结果
      3. 4.1.3. 返回数据结构
   2. 4.2. POST 修改配置
      1. 4.2.1. 请求参数
      2. 4.2.2. 返回结果
      3. 4.2.3. 返回数据结构
   3. 4.3. POST 录入学生成绩
      1. 4.3.1. 请求参数
      2. 4.3.2. 返回结果
      3. 4.3.3. 返回数据结构
   4. 4.4. GET 获取待录入成绩考生列表
      1. 4.4.1. 请求参数
      2. 4.4.2. 返回结果
      3. 4.4.3. 返回数据结构
5. 5. 高中端
   1. 5.1. GET 获取已报考我校学生列表
      1. 5.1.1. 请求参数
      2. 5.1.2. 返回结果
      3. 5.1.3. 返回数据结构
   2. 5.2. POST 根据分数线录取考生
      1. 5.2.1. 请求参数
      2. 5.2.2. 返回结果
      3. 5.2.3. 返回数据结构
6. 6. 初中端
   1. 6.1. POST 添加考生
      1. 6.1.1. 请求参数
      2. 6.1.2. 返回结果
      3. 6.1.3. 返回数据结构
7. 7. 学生端
   1. 7.1. POST 登录账号
      1. 7.1.1. 请求参数
      2. 7.1.2. 返回结果
      3. 7.1.3. 返回数据结构
   2. 7.2. GET 获取高中列表
      1. 7.2.1. 返回结果
      2. 7.2.2. 返回数据结构
   3. 7.3. POST 填报志愿
      1. 7.3.1. 请求参数
      2. 7.3.2. 返回结果
      3. 7.3.3. 返回数据结构
   4. 7.4. GET 获取已填报的志愿
      1. 7.4.1. 请求参数
      2. 7.4.2. 返回结果
      3. 7.4.3. 返回数据结构
   5. 7.5. GET 查询成绩
      1. 7.5.1. 请求参数
      2. 7.5.2. 返回结果
      3. 7.5.3. 返回数据结构
   6. 7.6. GET 查询录取结果
      1. 7.6.1. 请求参数
      2. 7.6.2. 返回结果
      3. 7.6.3. 返回数据结构
8. 8. 数据模型

默认模块

Base URLs:

Authentication

Default

GET 初始化管理员账号

GET /zk/init-admin/

返回示例

200 Response

{}

返回结果

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

返回数据结构

POST 用户登录

POST /zk/user-login/

Body 请求参数

username: ""
password: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» username	body	string	是	用户名，非昵称
» password	body	string	是	密码，不用md5加密

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 获取某个配置

GET /zk/options/get/

请求参数

名称	位置	类型	必选	说明
key	query	string	是	配置项名称

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 获取当前登录用户信息

GET /zk/me/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

管理端

POST 添加学校

POST /zk/schools/add/

Body 请求参数

token: ""
id: ""
password: ""
name: ""
role: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» id	body	string	是	学校登录名
» password	body	string	是	学校密码
» name	body	string	是	学校名称
» role	body	string	是	学校角色,1为高中,2为初中

返回示例

200 Response

{}

返回结果

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

返回数据结构

POST 修改配置

POST /zk/options/change/

Body 请求参数

token: ""
key: ""
val: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» key	body	string	是	如is_register
» val	body	string	是	yes/no

返回示例

200 Response

{}

返回结果

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

返回数据结构

POST 录入学生成绩

POST /zk/students/score-input/

Body 请求参数

token: ""
card: ""
score: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» card	body	string	是	学生身份证号
» score	body	string	是	学生总分

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 获取待录入成绩考生列表

GET /zk/students/nocj_list/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

高中端

GET 获取已报考我校学生列表

GET /zk/students/zy_list/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

POST 根据分数线录取考生

POST /zk/students/admit/

Body 请求参数

token: ""
standard: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» standard	body	string	是	分数线

返回示例

200 Response

{}

返回结果

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

返回数据结构

初中端

POST 添加考生

POST /zk/students/add/

Body 请求参数

token: ""
name: ""
password: ""
card: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» name	body	string	是	none
» password	body	string	是	none
» card	body	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

学生端

POST 登录账号

POST /zk/students/login/

Body 请求参数

card: ""
password: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» card	body	string	是	考生身份证号
» password	body	string	是	密码,不用md5加密

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 获取高中列表

GET /zk/students/all_zy/

返回示例

200 Response

{}

返回结果

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

返回数据结构

POST 填报志愿

POST /zk/students/tbzy/

Body 请求参数

token: ""
zy: ""

请求参数

名称	位置	类型	必选	说明
body	body	object	是	none
» token	body	string	是	none
» zy	body	string	是	填高中id

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 获取已填报的志愿

GET /zk/students/zy/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

GET 查询成绩

GET /zk/students/score/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{"status":"failed","message":"\u975e\u6cd5\u53c2\u6570","data":""}

返回结果

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

返回数据结构

GET 查询录取结果

GET /zk/students/result/

请求参数

名称	位置	类型	必选	说明
token	query	string	是	none

返回示例

200 Response

{}

返回结果

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

返回数据结构

数据模型