创建班级

正式环境

POST

https://www.plaso.cn/dataentry/group/create

最后修改时间：2024-12-17 06:31:37

1.一个班级对应一个教师
2.班级具有有效期,失效后教师学生看不到这个班级
3.班级可设置年级学科属性
通过该接口可以向伯索云学堂系统中添加班级，添加成功后返回班级的Id。

请求参数

Body 参数application/json

groupName

string

班级名称,不超过50个字符

必需

activeBegin

number

班级生效时间(秒)

必需

activeEnd

number

班级失效时间(秒),不能早于现在

必需

teacherId

string

教师ID,使用教师创建接口返回的ID

必需

assistantId

string

助教ID,使用助教创建接口返回的ID

可选

groupTeacherList

string

老师列表

可选

非必填，userId是string类型，courseId是int类型。如"[{"userId": "0_1703181","courseId": 53 }]"

groupRemarks

string

描述,不超过200个字符

可选

serviceFlag

integer

班级类型

可选

1表示服务班级（默认为1）；2表示普通班级。

示例

{
  "groupName": "0_1703181的班级",
  "teacherId": "0_1703181",
  "activeEnd": 1731114482,
  "activeBegin": 1699523676,
  "groupTeacherList": "[{\"userId\": \"0_1703181\",\"courseId\": 53 }]",
  "serviceFlag": 1,
  "groupRemarks": "Plaso-OpenAPI使用场景",
  "assitantId": "302_30388925"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.plaso.cn/dataentry/group/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupName": "0_1703181的班级",
    "teacherId": "0_1703181",
    "activeEnd": 1731114482,
    "activeBegin": 1699523676,
    "groupTeacherList": "[{\"userId\": \"0_1703181\",\"courseId\": 53 }]",
    "serviceFlag": 1,
    "groupRemarks": "Plaso-OpenAPI使用场景",
    "assitantId": "302_30388925"
}'

返回响应

🟢200请求成功

application/json

Body

code

number

响应码

必需

obj

object

可选

groupId

number

班级ID

必需

msg

string

信息

可选

param

string

异常参数

可选

reqId

string

请求Id

必需

reqTime

number

请求时间

必需

execTime

number

执行时间

必需

示例

成功示例参数缺失参数无效

{
  "code": 0,
  "obj": {
    "groupId": 100310453
  },
  "reqId": "1699510318005_0.27186998363652126",
  "reqTime": 1699510318006,
  "execTime": 72
}

修改于 2024-12-17 06:31:37

获取课堂互动信息

更新班级