生成班级码

使用场景： 学校教师生成班级码。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	支持
机构凭证	不支持	-

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/classcode/mcreate

Query参数:

参数	类型	必填	说明
access_token	string	是	接口调用凭证

Body参数：

参数	类型	必须	说明
department_ids	[]uint32	是	班级id列表
expired_time	uint32	否	有效期(分钟) 有效时间[1 ~ 720]分钟区间，不填时，默认110分钟

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
class_code	string	班级码（参考附录参数加解密说明里开放接口参数加解密章节)
class_code_password	string	登录密码（参考附录参数加解密说明里开放接口参数加解密章节)
department_ids	[]uint32	班级id列表
end_time	string	班级码的结束时间(时间戳)

密码加解密demo示例

明文: 918984

EncodeAesKey: vzH3cwuHt4Uo6IIPcWjHl9hqu7NCAUfN6cGxGKbicBh

密文: 51LdiKscpyn+le9v4hpGzOxkt4qJigvYNir2kok9fB0=

POST  https://jz.hasmartedu.com/oapi/school/classcode/mcreate?access_token=ACCESS_TOKEN

请求包体：

 {
    "department_ids": [100001,100002], 
    "expired_time":720
 }

返回示例：

{
   "errcode": 0,
   "errmsg": "ok",
   "class_code": "51LdiKscpyn+le9v4hpGzOxkt4qJigvYNir2kok9fB0=",
   "class_code_password": "k8AbdZDYLuw/kyVp1k7QofhKZV6y3St1v9QIzJ/LvvA=",
   "department_ids": [100001,100002], 
   "end_time":"1646038466"
}

获取班级码

使用场景： 教师查询班级码。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	支持
机构凭证	不支持	-

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/classcode/mget

Query参数:

参数	类型	必填	说明
access_token	string	是	接口调用凭证

Body参数：

参数	类型	必须	说明
department_ids	[]uint32	是	班级id列表

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
data_list	object	班级码列表
data_list.class_code	string	班级码（参考附录参数加解密说明里开放接口参数加解密章节)
data_list.class_code_password	string	登录密码（参考附录参数加解密说明里开放接口参数加解密章节)
data_list.department_id	uint32	班级id
data_list.end_time	string	班级码的结束时间(时间戳)

POST  https://jz.hasmartedu.com/oapi/school/classcode/mget?access_token=ACCESS_TOKEN

请求包体：

 {
    "department_ids": [100001,100002]
 }

返回示例：

{
   "errcode": 0,
   "errmsg": "ok",
   "data_list":[
           {
               "class_code": "51LdiKscpyn+le9v4hpGzOxkt4qJigvYNir2kok9fB0=",
            "class_code_password": "k8AbdZDYLuw/kyVp1k7QofhKZV6y3St1v9QIzJ/LvvA=",
               "department_id":100001,
               "end_time":"1646038466"
           },
           {
               "class_code": "51LdiKscpyn+le9v4hpGzOxkt4qJigvYNir2kok9fB0=",
            "class_code_password": "k8AbdZDYLuw/kyVp1k7QofhKZV6y3St1v9QIzJ/LvvA=",
               "department_id":100002,
               "end_time":"1646038466"
           }
   ]

}

停用班级码

使用场景： 停用班级码。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	支持
机构凭证	不支持	-

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/classcode/cancel

Query参数:

参数	类型	必填	说明
access_token	string	是	接口调用凭证

Body参数：

参数	类型	必须	说明
department_ids	[]uint32	是	班级id列表

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容

POST  https://jz.hasmartedu.com/oapi/school/classcode/cancel?access_token=ACCESS_TOKEN

请求包体：

 {
    "department_ids": [100001,100002]
 }

返回示例：

{
   "errcode": 0,
   "errmsg": "ok",
}

生成班级码

获取班级码

停用班级码

results matching ""

No results matching ""

results matching ""

No results matching ""