Classroom-华为云

Classroom-产品概述:什么是Classroom？

什么是Classroom？ Classroom是基于华为云的一站式软件教学与实践平台，支持高校师生实现备课、上课、作业、考试、实验、实训等全教学流程的线上教学，提供多类习题自动判题、企业级DevOps实训、免费在线习题库等众多高级特性辅助进行数字化教学转型。为学生提供从单个函数到企业级项目的软件开发实践平台，帮助老师更方便的开展授课、演示及软件实践教学，并为老师更全面的了解学生软件开发能力短板提供智能数据分析支持。 Classroom教学平台结合DevCloud践行产教融合新模式，搭建业界领先的“教-学-练-赛-考-评-证”一体化赋能体系。教培机构与在校师生可以通过Classroom进行实时互动，极大提升了教学体验。教师可以进行我的工作台、课件管理、课件实时预览、课件分享、作业判题、班级管理等；学生可以接受作业、开展作业并提交作业给教师、查看教师评分等 Classroom 云上软件教学服务，支持全类型课程工程实训，提供30多种精品课程，10多种企业类实践课程，3000多种习题支持秒级自动判题，覆盖10种开发语言课程打造国内首个教育知识点自动检测服务，支持多种知识点检测云上实验室，提供教学所需的多场景通用型实训环境，海量全品类课程资源库覆盖20+赛道，500门课程。

Classroom

Classroom-产品优势:科技竞赛

科技竞赛面向企业和高校针对人才竞争、识别与评估提供竞赛服务解决方案。开放华为竞赛平台办赛能力，为各企业、机构、高校等提供赛前、赛中、赛后的咨询、办赛、运营等能力，赋能每一次赛事。提供分层核心办赛能力、在线评判与多类赛道比拼，助力推广高校品牌影响力。提升人才技能识别效率，形成以学促赛-以赛助学的人才成长驱动力。提供API对接方案，使能第三方平台集成赛事报名、作品提交、评判、名次排行等功能。

Classroom

Classroom-产品特性:科技竞赛

科技竞赛提供端到端的办赛能力，提供奖金丰厚和高含金量的各类竞赛，以赛代练。以赛促学促练，丰富领域主题赛事，自由选择赛道，比赛项目实操，增强实战经验。丰富人才识别途径，解决人才识别途径单一痛点，以赛果作品筛选人才，提高招聘效率。为赛事主办方与参赛者提供双向识别，双向选择通道。开放竞赛平台办赛能力，为各企业、机构、高校等提供赛前、赛中、赛后的咨询、办赛、运营等能力，赋能每一次赛事。提供API对接方案，使能第三方平台集成赛事报名、作品提交、评判、名次排行等功能。提供企业专家云集的学习交流论坛。

Classroom

Classroom-查询课堂下指定成员的作业信息:响应参数

响应参数状态码： 200 表4 响应Body参数参数参数类型描述 jobs Array of MemberJobCard objects 课堂下作业列表信息 total Integer 学生作业总数表5 MemberJobCard 参数参数类型描述 name String 作业名称 average_score String 作业均分(作业有均分该字段才返回) score Integer 作业得分(作业有分数该字段才返回) send_time String 作业下发时间, 日期格式：yyyy-MM-dd HH:mm:ss last_submit_time String 作业最后一次提交时间, 日期格式：yyyy-MM-dd HH:mm:ss 状态码： 400 表6 响应Body参数参数参数类型描述 error_code String 异常错误码 error_msg String 异常错误描述状态码： 403 表7 响应Body参数参数参数类型描述 error_code String 异常错误码 error_msg String 异常错误描述状态码： 500 表8 响应Body参数参数参数类型描述 error_code String 异常错误码 error_msg String 异常错误描述

Classroom

Classroom-查询课堂下指定成员的作业信息:响应示例

响应示例状态码： 200 OK { "jobs" : [ { "name" : "作业", "average_score" : "99", "score" : 100, "send_time" : "2019-12-12 12:00:00", "last_submit_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" : "服务内部错误"}

Classroom

Classroom-查询课堂下指定成员的作业信息:URI

URI GET /v3/classrooms/{classroom_id}/jobs 表1 路径参数参数是否必选参数类型描述 classroom_id 是 String 课堂ID 最小长度：32 最大长度：32 表2 Query参数参数是否必选参数类型描述 member_id 是 String 用户ID 最小长度：32 最大长度：32 offset 否 Integer 信息记录的起始编号最小值：1 最大值：1000 limit 否 Integer 每页包含的信息记录数最小值：1 最大值：100

Classroom

Classroom-构造请求:请求消息头

请求消息头附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。如下公共消息头需要添加到请求中。 Content-Type：消息体的类型（格式），必选，默认取值为“application/json”，有其他取值时会在具体接口中专门说明。 X-Auth-Token：用户Token，可选，当使用Token方式认证时，必须填充该字段。用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。公有云API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权。 X-Project-ID：子项目ID，可选，在多项目场景中使用。 X-Domain-ID：账号ID。对于获取用户Token获取请求认证接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json

Classroom

Classroom-构造请求:请求消息体

请求消息体请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。对于获取用户Token获取请求认证接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxxxx为project的名称，如cn-north-1，您可以从地区和终端节点中获取。 scope参数定义了Token的作用域，下面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token获取请求认证。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokensContent-Type: application/json{ "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } }} 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token获取请求认证接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

Classroom

Classroom-示例4：下发判题并查询判题结果以及下载结果:操作步骤

操作步骤下发判题任务。接口信息 URI：GET /v1/enablement/judgements API文档详情请参见：下发判题任务 API Explorer 在线调试请参见：下发判题任务说明输出类型为文件生成类型时(output_type为fileout)，不需要指定生成路径，程序会将标准输出的输出流写入文件并返回文件id。输出类型为图片生成类型时(output_type为imgout), 需要指定生成路径，并且须生成在目录"/projects/output/"下，程序会返回图片的id。请求示例 POST https://classroom-ext.cn-north-4.myhuaweicloud.com/v1/enablement/judgements 响应示例 {"notify_url": "https://117.12.143.1/taskBack","code_type": "inline","source_code": "aW1wb3J0IG9zCnByaW50KCIyMDIxLTA3LTE0Iik=","description": "java code","runtime_type": "java","timeout": 60,"output_type": "sysout"} 根据判题任务id查询判题结果。接口信息 URI：GET v1/enablement/judgements/{judgement_id} API文档详情请参见：获取判题结果详情 API Explorer在线调试请参见：获取判题结果详情请求示例 GET https://classroom-ext.cn-north-4.myhuaweicloud.com/v1/enablement/judgements/933b85316de54cea9e650d5f4f6b7ad2 响应示例 { "task_status": "callback_success", "status": "compile_error", "judgement_id": "933b85316de54cea9e650d5f4f6b7ad2", "start_time": "2021-07-15 19:49:22", "end_time": "2021-07-15 19:49:28", "result": { "output": "java sysout", // 下发判题时output_type为sysout或代码出错时只会返回output字段 "file_id": "b47e7d4e-ae9e-43a2-a452-c2aa6bfb5ee9.txt", // 下发判题时output_type为fileout只会返回file_id字段 "image_id": "94737d4e-ae9e-43a2-9702-bda76bfb5ee9.png" // 下发判题时output_type为imgout只会返回image_id字段 "testcases": [ // 下发判题时output_type为caseout或judgeout只会返回testcases字段 { "input": "10 20", "output": "30" } ] }} 下载判题结果文件。接口信息 URI：GET /v1/enablement/judgement/files/{file_id} API文档详情请参见：获取判题结果详情 API Explorer在线调试请参见：下载判题结果文件请求示例 GET https://classroom-ext.cn-north-4.myhuaweicloud.com/v1/enablement/judgement/files/b47e7d4e-ae9e-43a2-a452-c2aa6bfb5ee9.txt 响应示例文件流的形式返回。

Classroom

Classroom-构造请求:请求URI

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 URI-scheme：表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint：指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点中获取。例如 IAM 服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path：资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string：查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。例如，您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token获取请求认证的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

Classroom

Classroom-构造请求:请求方法

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。 GET：请求服务器返回指定资源。 PUT：请求服务器更新指定资源。 POST：请求服务器新增资源或执行特殊操作。 DELETE：请求服务器删除指定资源，如删除对象等。 HEAD：请求服务器资源头部。 PATCH：请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。在获取用户Token获取请求认证的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

Classroom

Classroom-概述

概述 Classroom是基于华为云的云上软件教学服务，支持高校师生实现备课、上课、作业、考试、实验、实训等全教学流程的线上教学，提供多类习题自动判题、企业级DevOps实训、免费在线习题库等众多高级特性辅助进行数字化教学转型。您可以使用本文档提供API对Classroom 进行相关操作，如获取当前用户的课堂列表，查询指定作业下的习题信息等，支持的全部操作请参见伙伴赋能概览。在调用API之前，请确保已经充分了解Classroom相关概念，详细信息请参见产品介绍。父主题：使用前必读

Classroom

Classroom-返回结果:响应消息体

响应消息体响应消息体通常以结构化格式返回，与响应消息头中Content-type对应，传递除响应消息头之外的内容。对于获取用户Token获取请求认证接口，返回如下消息体。为篇幅起见，这里只展示部分内容。 { "token": { "expires_at": "2019-02-13T06:52:13.855000Z", "methods": [ "password" ], "catalog": [ { "endpoints": [ { "region_id": "cn-north-1",...... 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 { "error_msg": "The format of message is error", "error_code": "AS.0001"} 其中，error_code表示错误码，error_msg表示错误描述信息。

Classroom

Classroom-错误码

错误码当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。更多服务错误码请参见API错误中心。状态码错误码错误信息描述处理措施 200 CM.0001 目标教学课程或者大赛不存在目标教学课程或者大赛不存在 200 CM.0002 参数错误参数错误 200 CM.0003 您不是课堂成员,无权操作您不是课堂成员,无权操作 200 CM.0006 课堂不存在或您没有权限查看课堂不存在或您没有权限查看 200 CM.0252 调用组装资源服务异常调用组装资源服务异常 200 CM.0253 用户无权限操作习题用户无权限操作习题 200 CM.0301 习题参数有误习题参数有误 200 CM.0309 请确认作业是否已删除请确认作业是否已删除 200 CM.0320 用户无权限操作作业用户无权限操作作业 400 CM.0450 系统繁忙，请稍后再试系统内部异常 400 CM.0461 资源不存在或者用户权限不足资源不存在或没有权限访问 400 CM.0502 习题类型与结果返回类型不匹配该习题类型不支持该结果返回类型 400 CM.0802 无权限操作无权限操作 400 CM.0804 未购买节点没有购买判题节点 400 CM.0805 判题类型和输出类型不符判题类型不支持所选的输出类型 400 CM.0806 并发数量达到上限并发判题任务数量达到购买的节点数上限 400 CM.0807 参数错误传入的参数有误 400 CM.0808 配置信息错误传入的回调地址参数与配置管理页上配置的不一致 400 CM.0809 不支持的回调通知地址传入的回调地址不支持访问 400 CM.0853 系统繁忙, 请稍后再试系统内部异常父主题：附录

Classroom

Classroom-查询习题库下习题列表:请求示例

请求示例 { "filter" : { "name" : "softwareTest", "exercise_type" : [ 1, 2, 3, 4 ], "difficult_ids" : [ "fce667e2b83b11e9be8dfa163eaf585c" ], "knowledge_point_ids" : [ "4ce986e2b7234474b0d2b81dbd091891" ] }, "start_index" : 1, "page_size" : 10} { "start_index" : 1, "page_size" : 10}

Classroom

云服务器内容精选

Classroom

7*24

备案

专业服务

退订

建议反馈

售前咨询热线