top
关闭

开发者登录

智慧作业数据回流

主要使用场景:智慧作业数据回流

1、AI批阅上报

基础 需要授权

AI完成作业批阅后调用,记录AI批阅行为数据。

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://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
}