查询指定课堂下的作业列表信息
功能介绍
查询指定课堂下的作业列表信息，支持分页查询。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v3/jobs
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
source_from |
是 |
String |
作业来源于课堂或课程。 取值范围： classroom:课堂作业 course:课程作业 最小长度：6 最大长度：9 |
source_id |
是 |
String |
课堂ID或者课程ID。 最小长度：32 最大长度：32 |
offset |
否 |
Integer |
信息记录的起始编号 最小值：1 最大值：1000 |
limit |
否 |
Integer |
每页包含的信息记录数 最小值：1 最大值：100 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
x-auth-token |
是 |
String |
用户token |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
jobs |
Array of JobCard objects |
作业列表 |
total |
Integer |
作业总数 |
参数 |
参数类型 |
描述 |
|---|---|---|
name |
String |
作业名称 |
job_id |
String |
作业ID |
is_send |
String |
作业下发状态(unsend:作业未下发, send:作业已下发) |
end_time |
String |
作业截止时间, 日期格式：yyyy-MM-dd HH:mm:ss |
average_score |
String |
作业均分 |
submit_job_num |
Integer |
作业提交人数 |
create_status |
String |
作业创建状态(yes:作业可以下发, no:作业不能下发) |
send_type |
String |
作业下发类型(specific:指定成员下发, all:下发课堂全员) |
is_score_visibility |
String |
作业成绩是否公布(unpublish:表示未公布成绩, publish:表示已公布成绩) |
send_time |
String |
作业下发时间, 日期格式：yyyy-MM-dd HH:mm:ss |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
异常错误码 |
error_msg |
String |
异常错误描述 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
异常错误码 |
error_msg |
String |
异常错误描述 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
error_code |
String |
异常错误码 |
error_msg |
String |
异常错误描述 |
请求示例
GET https://{endpoint}/v3/jobs
响应示例
状态码： 200
OK
{
"jobs" : [ {
"name" : "作业",
"job_id" : "0632910a5115448da1eb92202592fa24",
"is_send" : "send",
"end_time" : "2019-12-12 12:00:00",
"average_score" : "1.5",
"submit_job_num" : 10,
"create_status" : "yes",
"send_type" : "all",
"is_score_visibility" : "unpublish",
"send_time" : "2019-12-12 12:00:00"
} ],
"total" : 1
}
状态码： 400
Bad Request
{
"error_code" : "CM.0003",
"error_msg" : "请求参数有误"
}
状态码： 403
Forbidden
{
"error_code" : "CM.0001",
"error_msg" : "请求被拒绝访问"
}
状态码： 500
Internal Server Error
{
"error_code" : "CM.0000",
"error_msg" : "服务内部错误"
}
状态码
状态码 |
描述 |
|---|---|
200 |
OK |
400 |
Bad Request |
403 |
Forbidden |
500 |
Internal Server Error |
错误码
请参见错误码。
