主要使用场景:智慧作业数据回流
AI完成作业批阅后调用,记录AI批阅行为数据。
获取接口访问令牌:accessToken
| url | https://api.wuhaneduyun.cn/homework/v1/ai-mark/report |
| 请求方式 | post |
| 是否需要鉴权 | 是 |
| 请求数限制 | 否 |
| 接口方向 | 第三方应用->开放平台 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
isbn |
必选 |
VARCHAR |
20 |
教辅书本编码(ISBN),国际标准书号 |
2 |
page_number |
必选 |
INT |
4 |
教辅书本页码,作业所在页码 |
3 |
school_code |
必选 |
VARCHAR |
20 |
学校标识码,全国统一编码 |
4 |
class_code |
必选 |
VARCHAR |
20 |
班级唯一标识 |
5 |
student_esn |
必选 |
VARCHAR |
20 |
学生编码(ESN),教育部发行可信数字身份号 |
6 |
app_id |
必选 |
VARCHAR |
50 |
服务企业标识(APPID),由市局分配 |
7 |
scan_device_id |
必选 |
VARCHAR |
50 |
扫描设备唯一标识,由企业自定 |
8 |
scan_time |
必选 |
DATETIME |
- |
作业扫描时间 |
9 |
ai_mark_id |
必选 |
VARCHAR |
50 |
AI批阅记录唯一标识 |
10 |
ai_model |
必选 |
VARCHAR |
500 |
AI模型名称/版本 |
11 |
ai_mark_time |
必选 |
DATETIME |
- |
AI批阅完成时间 |
| 序号 | 字段名 | 约束 | 类型 | 长度 | 说明 |
|---|---|---|---|---|---|
1 |
code |
必选 |
int |
- |
响应码,0 表示成功,非 0 表示失败 |
2 |
message |
必选 |
string |
- |
响应消息,失败时返回具体错误原因 |
3 |
data |
可选 |
object/null |
- |
响应数据,当前接口均为 null |
4 |
timestamp |
必选 |
long |
- |
响应时间戳(毫秒) |
**请求示例**
{
"isbn": "978-7-5582-4027-6",
"page_number": 1,
"school_code": "1142011842",
"class_code": "0501",
"student_esn": "3181175579",
"app_id": "4e9e8306e7be462cbd7006de7c7bf645",
"scan_device_id": "dev-2026001001",
"scan_time": "2026-03-25 18:30:00",
"ai_mark_id": "ai-mark-001",
"ai_model": "homework-correction-v2.1",
"ai_mark_time": "2026-03-25 18:32:00"
}
**响应示例**
{
"code": 0,
"message": "success",
"data": null,
"timestamp": 1743412800000
}