心理健康检测系统接口文档

1.接口说明：学生登录接口

请求接口：childlogin.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
username	string	是	学生姓名
password	string	是	学生密码

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/500
msg	string	是	“用户名不存在请先去注册”/“密码错误”/“用户名为空”
flag	int	是	flag为0时表示有错可查看err/flag为1时表示可进行下一步考试操作

2.接口说明：学生注册接口

请求接口：childregister.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
username	string	是	学生姓名
password	string	是	学生密码
phone	string	是	家长手机号
age	string	是	学生年龄
sex	string	是	学生性别

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/400/500
msg	string	是	“注册成功”/“参数为空”/“已存在,请不要重复注册”/“注册失败,请重试”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步登录操作

3.家长登录接口（保留接口 正在开发中）
请求接口：parentlogin.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
phone	string	是	电话号码
code	string	是	验证码

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/400
msg	string	是	“手机号不存在请先去注册”/“验证码错误”
flag	int	是	flag为0时表示有错可查看err/flag为1时表示可进行下一步查看结果操作

4.家长注册接口
请求接口：parentregister.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
name	string	是	家长姓名
phone	string	是	手机号
sex	string	是	学生性别
child	string	是	孩子姓名

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/400/500
msg	string	是	“注册成功”/“参数为空”/“已存在,请不要重复注册”/“注册失败,请重试”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步登录操作

5.管理员登录接口
请求接口：adminlogin.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
code	string	是	邀请码
password	string	是	密码

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/400/500
msg	string	是	“登录成功”/“参数为空”/“邀请码错误”/“密码错误”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步登录操作

6.管理员查看所有试卷接口
请求接口：allpapers.php
请求方式：GET
返回参数：Json

参数名	类型	是否有	说明
data	json	是	所以有数据的key
id	int	是	试卷数目序号
p_id	int	是	试卷序号
total	int	是	试卷总分
range_a	string	是	80-100范围内的评分
range_b	string	是	60-79范围内的评分
range_c	string	是	小于60的评分
create_time	datetime	是	试卷创建的时间

7.管理员查看所有考生的考试记录接口
请求接口：allexams.php
请求方式：GET
返回参数：Json

参数名	类型	是否有	说明
data	json	是	所以有数据的key
id	int	是	考试记录序号
name	string	是	学生姓名
p_id	int	是	所答的试卷序号
all_answer	string	是	所有题目的答案类1A2B3C
total	int	是	所的总分
comment	string	是	评语
start_time	datetime	是	答题开始时间
end_time	datetime	是	答题结束时间

8.管理员增加题目接口

请求接口：addquestion.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
p_id	string	是	试卷号
question	string	是	问题内容
answer_a	string	是	A答案
answer_b	string	是	B答案
answer_c	string	是	C答案
answer_d	string	是	D答案
true_answer	string	是	正确答案
score	string	是	得分

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/500
msg	string	是	“参数错误”/“注册成功”/“密码失败请重试”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步操作

9.管理员删除题目接口
请求接口：deletequestion.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
p_id	string	是	试卷序号
q_id	int	是	题目序号

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/500
msg	string	是	“参数错误”/“删除失败”/“删除成功”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步操作

10.管理员更新题目接口
请求接口：updatequestion.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
p_id	string	是	试卷号
q_id	string	是	问题序号
question	string	是	问题内容
answer_a	string	是	A答案
answer_b	string	是	B答案
answer_c	string	是	C答案
answer_d	string	是	D答案
true_answer	string	是	正确答案
score	string	是	得分

返回参数：Json

参数名	类型	是否有	说明
code	int	是	200/500
msg	string	是	“参数错误”/“更新成功”/“更新失败请重试”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步操作

11.管理员查看套题接口
请求接口：selectquestion.php
请求方式：POST
请求参数：Json

参数名	类型	是否必须	说明
p_id	string	是	试卷序号

返回参数：Json

参数名	类型	是否必须	说明
data	json	是	json数组key
q_id	string	是	题目序号
question	string	是	问题内容
answer_a	string	是	A答案
answer_b	string	是	B答案
answer_c	string	是	C答案
answer_d	string	是	D答案
true_answer	string	是	正确答案
score	string	是	得分

12.分发试卷接口
请求接口：distrubute.php
请求方式：GET
返回参数：Json

参数名	类型	是否必须	说明
data	json	是	json数组key
p_id	int	是	试卷序号（保留）
info	json	是	json数组 包含每道题目的信息
q_id	string	是	info中的题目序号
question	string	是	info中的 问题内容
answer_a	string	是	info中的 A答案
answer_b	string	是	info中的 B答案
answer_c	string	是	info中的C答案
answer_d	string	是	info中的D答案

13.学生考试接口
请求接口：doexam.php
请求方式：POST
请求参数：Json

参数名	类型	是否有	说明
name	string	是	学生姓名
p_id	int	是	所答的试卷序号
answer	string	是	所有题目的答案类1A2B3C
start_time	datetime	是	答题开始时间
end_time	datetime	是	答题结束时间

返回参数：JSON

参数名	类型	是否必须	说明
sum	int	是	总分
comment	string	是	评语

14.发送短信接口
接口详情：管理员一件筛选总分在60分以下的学生并向家长发送短信
请求接口：screen.php
请求方式：GET
返回参数：JSON

参数名	类型	是否有	说明
code	int	是	200/500
msg	string	是	“发送成功”/“发送失败”
flag	int	是	flag为0时表示有错/flag为1时表示可进行下一步操作