top

关闭

开发者登录

记住我

忘记密码？

登录注册

数据回流接口说明

作业数据上报字典说明

1.公共请求参数字段说明

字段名	类型	长度	必填	校验规则	说明	示例
isbn	VARCHAR	20	是	ISBN-10 或 ISBN-13 格式	教辅书本编码（ISBN），国际标准书号	`978-7-5582-4027-6`
page_number	INT	4	是	范围：1-9999	教辅书本页码，作业所在页码	`1`
school_code	VARCHAR	20	是	非空	学校标识码，全国统一编码	`1142011842`
class_code	VARCHAR	20	是	4位数字，前2位年级(01-12)+后2位班级号	班级唯一标识	`0501`
student_esn	VARCHAR	20	是	非空	学生编码（ESN），教育部发行可信数字身份号	`3181175579`
app_id	VARCHAR	50	是	非空	服务企业标识（APPID），由市局分配	`4e9e8306e7be462cbd7006de7c7bf645`
scan_device_id	VARCHAR	50	是	非空	扫描设备唯一标识，由企业自定	`dev-2026001001`
scan_time	DATETIME	-	是	格式：yyyy-MM-dd HH:mm:ss	作业扫描时间	`2026-03-25 18:30:00`

2.接口专用字段说明

2.1 AI批阅上报（额外字段）

字段名	类型	长度	必填	校验规则	说明	示例
ai_mark_id	VARCHAR	50	是	非空	AI批阅记录唯一标识	`ai-mark-001`
ai_model	VARCHAR	500	是	非空	AI模型名称/版本	`homework-correction-v2.1`
ai_mark_time	DATETIME	-	是	格式：yyyy-MM-dd HH:mm:ss	AI批阅完成时间	`2026-03-25 18:32:00`

2.2 教师复批上报（额外字段）

字段名	类型	长度	必填	校验规则	说明	示例
teacher_mark_id	VARCHAR	50	是	非空	教师复批记录唯一标识	`teacher-mark-001`
teacher_esn	VARCHAR	20	是	非空	教师编码（ESN），教育部发行可信数字身份号	`3181175580`
teacher_mark_time	DATETIME	-	是	格式：yyyy-MM-dd HH:mm:ss	教师复批完成时间	`2026-03-25 18:35:00`

2.3 打印上报（额外字段）

字段名	类型	长度	必填	校验规则	说明	示例
print_device_id	VARCHAR	50	是	非空	打印设备唯一标识	`print-001`
teacher_esn	VARCHAR	20	是	非空	教师编码（ESN），教育部发行可信数字身份号	`3181175580`
print_time	DATETIME	-	是	格式：yyyy-MM-dd HH:mm:ss	打印完成时间	`2026-03-25 18:40:00`

3.自动填充字段说明（无需传递）

字段名	类型	计算规则	说明	示例
academic_year	VARCHAR(20)	9月开学，学年格式为"YYYY-YYYY"	学年	`2025-2026`
semester	VARCHAR(10)	01-上学期(9月-次年1月)，02-下学期(2月-8月)	学期	`02`
education_stage_code	VARCHAR(10)	基于ISBN自动查询	学段代码	`01`
grade_code	VARCHAR(10)	基于ISBN自动查询	年级代码	`05`
subject_code	VARCHAR(10)	基于ISBN自动查询	学科代码	`02`

4.响应字段说明

字段	类型	说明
code	int	响应码，0 表示成功，非 0 表示失败
message	string	响应消息，失败时返回具体错误原因
data	object/null	响应数据，当前接口均为 null
timestamp	long	响应时间戳（毫秒）

5.错误码字典

错误码	错误类型	说明
0	成功	请求处理成功
1001	参数错误	请求参数校验失败，请检查参数格式和必填项
1002	业务错误	学校不存在或已禁用
1003	业务错误	企业不存在或已禁用
1004	业务错误	教辅书本不存在或已禁用
1005	业务错误	学生不存在或已禁用
1006	业务错误	教师不存在或已禁用
1007	业务错误	学生不属于该校
1008	业务错误	教师不属于该校
1009	业务错误	学生班级与上报班级不一致
2001	系统错误	市平台数据上报失败
9999	系统错误	系统内部异常

6.学段代码字典

代码	学段
01	小学
02	初中
03	高中

7.学科代码字典

代码	学科
01	语文
02	数学
03	英语
04	物理
05	化学
06	生物
07	历史
08	地理
09	政治

8.学期代码字典

代码	学期
01	上学期（9月-次年1月）
02	下学期（2月-8月）

9.班级代码格式字典

位置	含义	取值范围	示例
第1-2位	年级	01-12	`05` 表示5年级
第3-4位	班级号	01-99	`01` 表示1班

示例：0501 表示5年级1班

10.年级代码字典

代码	年级
01	一年级
02	二年级
03	三年级
04	四年级
05	五年级
06	六年级
07	七年级
08	八年级
09	九年级
10	十年级
11	十一年级
12	十二年级

注：年级代码与学段关联，小学为01-06，初中为07-09，高中为10-12。