新增班级

POST

https://api2.hik-cloud.com/api/v1/edu/basic/class

功能描述

平台新增一个班级。创建班级前需登录平台开启学段并配置学制及年级，添加班级后会自动计算入学年份（参数不在接口中体现，毕业需按照此参数判定）；同一年级下班级名称不能重复。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api2.hik-cloud.com/api/v1/edu/basic/class' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{

         
    "classInfo": {

         
        "studyLevel": 1,

         
        "gradeIndex": 1,

         
        "className": "王凯测试班级",

         
        "classCode": "125"

         
    },

         
    "classAlias":"班级别名",

         
    "classSlogan":"班级口号",

         
    "comment":"备注信息",

         
    "classType": 1,

         
    "schoolId":"10a795f4a25d4de09edd091f28747eb6"

         
}'

响应示例

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "classId": "00a795f4a25d4de09edd091f28747eb4"
    }
}

请求参数

Header 参数

Authorization

string

可选

默认值:

Bearer {{access_token}}

Body 参数application/json

classInfo

object

班级信息

必需

studyLevel

integer

必需

学段必须在平台上启用(0: 幼儿园、1: 小学、2: 初中、3: 高中、4: 其他)

gradeIndex

integer

必需

年级不能超过平台配置最高年级(1: 一年级、2: 二年级、3: 三年级、4: 四年级、5: 五年级、6: 六年级、7: 七年级、8: 八年级、9: 九年级、10: 十年级)

className

string

必需

班级名称（同一个年级中,班级名称不能重复）

classCode

string

必需

班级编号（同一个学校中,班级编号不能重复）

classAlias

string

班级别名

可选

classSlogan

string

班级口号

可选

adviserId

string

班主任ID

可选

comment

string

备注

可选

classType

integer

可选

班级类型（1：行政班（默认）,2：教学班）

schoolId

string

学校ID

可选

示例

返回响应

🟢200成功

application/json

Body

code

integer

返回码

必需

message

string

返回消息

必需

data

object

节点对象

必需

classId

string

班级ID

必需

第三方公众号token更新

修改班级

新增班级

功能描述#

请求参数

返回响应

功能描述