向班级中添加学生

正式环境

https://www.plaso.cn/dataentry

POST

/group/join

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

通过该接口可以向班级中批量添加学生。添加成功后会返回对应的添加数和学生用户名信息，同时添加失败也会返回添加失败数。

请求参数

Body 参数application/json

groupId

number

班级ID

必需

studentIds

string

学生ID,学生创建接口返回的学生ID。多个学生时用英文逗号分开传值

必需

string类型的string数组，如"["1_30393141", "1_30393142"]"

示例

{
  "groupId": 1003101471,
  "studentIds": "[\"1_30393141\", \"1_30393142\"]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.plaso.cn/dataentry/group/join' \
--header 'Content-Type: application/json' \
--data-raw '{
    "groupId": 1003101471,
    "studentIds":"[\"1_30393141\", \"1_30393142\"]" 
}'

返回响应

🟢200请求成功

application/json

Body

code

number

必需

obj

object

可选

errNum

integer

添加失败学生数量

必需

sucNum

integer

添加成功学生数量

必需

studentNames

string

操作成功学生名称

必需

reqId

string

必需

reqTime

number

必需

execTime

number

必需

msg

string

可选

param

string

可选

示例

成功示例参数缺失无权限

{
  "code": 0,
  "obj": {
    "errNum": 0,
    "sucNum": 1,
    "studentNames": "zk1699430031148(wtest1699430031148)"
  },
  "reqId": "1699511725348_0.9715029263516093",
  "reqTime": 1699511725348,
  "execTime": 49
}

查询班级列表

从班级中移除学生