学生变动

使用场景： 学生退学、休学或者其他变动。

需注意的是：这部分变动后成员是非正常状态成员，在普通的成员接口中查询不到，需要通过该变动成员相关接口获取

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	未支持
机构凭证	支持	获取不到用户凭证的后台管理场景使用

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/student/move

Query参数:

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

Body参数：

参数	类型	必须	说明
userid	string	是	用户id
move_type	uint32	是	变动类型。2-休学，3-退学，4-其他变动
reason	string	否	变动原因

返回示例：

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

POST  https://jz.hasmartedu.com/oapi/school/student/move?access_token=ACCESS_TOKEN

请求包体：

 {
    "userid": "3724127543", 
    "move_type":2, 
    "reason":"变动原因"
 }

返回示例：

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

学生迁回

使用场景： 学生在退学、休学或者其他变动后，迁回学校。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	未支持
机构凭证	支持	获取不到用户凭证的后台管理场景使用

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/student/move_back

Query参数:

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

Body参数：

参数	类型	必须	说明
userid	string	是	用户id
department_ids	[]uint32	是	迁回的部门列表。部门必须是行政班级

返回示例：

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

POST  https://jz.hasmartedu.com/oapi/school/student/move_back?access_token=ACCESS_TOKEN

请求包体：

 {
    "id": 14506, 
    "userid":"3724127543", 
    "department_ids": [5010291]
 }

返回示例：

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

获取变动学生列表

使用场景： 获取学校已退休学的变动学生信息。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	未支持
机构凭证	支持	获取不到用户凭证的后台管理场景使用

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/student/list_move

Query参数：

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

Body参数：

参数	类型	必须	说明
move_type_list	[]uint32	否	变更类型列表。2-休学，3-退学，4-其他变动，5-已迁回，当数组为空时，拉取全部

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
result_list.id	Int	变更记录id
result_list.userid	string	学生id
result_list.name	string	学生姓名
result_list.user_no	string	学号
result_list.move_type	uint32	变更类型。2-休学，3-退学，4-其他变动，5-已迁回

POST  https://jz.hasmartedu.com/oapi/school/student/list_move?access_token=ACCESS_TOKEN

请求包体：

 {
    "move_type_list": [2,3,4]
 }

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "result_list": [
        {
            "id": 14730,
            "userid": "3723750365",
            "name": "小明",
            "user_no": "43",
            "move_type": 2
        },
        {
            "id": 14528,
            "userid": "3723750367",
            "name": "小黄",
            "user_no": "1",
            "move_type": 3
        }
    ]
}

检索变动学生

使用场景： 搜索学生变动列表。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	未支持
机构凭证	支持	获取不到用户凭证的后台管理场景使用

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/student/search_move

Query参数：

参数	类型	必须	说明
access_token	string	是	调用接口凭证
name	string	否	姓名（模糊搜索）
user_no	string	否	学号
move_type_list	[]string	否	变更类型列表。2-休学，3-退学，4-其他变动，5-已迁回，当数组为空时，拉取全部
page_index	uint32	否	第几页默认:1
page_size	uint32	否	每页数量默认:30

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
total	uint32	总数
data_list		数据列表
data_list.userid	string	用户id
data_list.name	string	用户名
data_list.user_no	string	学号
data_list.move_type	uint32	变更类型 2-休学，3-退学，4-其他变动，5-已迁回

POST  https://jz.hasmartedu.com/oapi/school/student/search_move?access_token=ACCESS_TOKEN&page_index=PAGE&page_size=SIZE

请求包体：

 {
    "name": "",
    "user_no": "",
    "move_type_list": [2,3,4],
    "page_index": 1,
    "page_size": 20
 }

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
          "id": 14730,
          "userid": "3723750365",
          "name": "小明",
          "user_no": "43",
          "move_type": 2
        },
        {
          "id": 14528,
          "userid": "3723750367",
          "name": "小黄",
          "user_no": "1",
          "move_type": 3
        }
    ],
    "total": 1
}

获取学生历史变动记录

使用场景： 获取学校已退休学的变动学生信息。

权限说明

权限项	说明	备注
应用是否需要申请白名单	需要	申请方式：联系项目接口人申请
用户凭证	未支持
机构凭证	支持	获取不到用户凭证的后台管理场景使用

请求方式： POST（HTTPS）

请求地址： https://jz.hasmartedu.com/oapi/school/student/move_log

Query参数：

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

Body参数：

参数	类型	必须	说明
move_type_list	[]uint32	否	变更类型列表。拉取指定变更类型的历史变动记录，2-休学，3-退学，4-其他变动，5-已迁回，当数组为空时，拉取全部
userid	string	是	用户id

返回示例：

参数	类型	说明
errcode	int32	返回码
errmsg	string	对返回码的文本描述内容
result_list.move_type	uint32	变动类型
result_list.move_time	string	变动日期，具体到天
result_list.depart_names	[]string	原班级信息
total	uint32	变更记录总数

POST  https://jz.hasmartedu.com/oapi/school/student/move_log?access_token=ACCESS_TOKEN

请求包体：

 {
    "move_type_list": [2,3,4,5],
    "userid": "3724127543"
 }

返回示例：

{
    "errmsg": "ok",
    "errcode": 0,
    "result_list": [
        {
            "move_type": 5,
            "move_time": "2021-03-11",
            "depart_names": [
              "学生/2010级/7班"
            ]
        },
        {
            "move_type": 2,
            "move_time": "2021-03-11",
            "depart_names": [
              "学生/2010级/7班"
            ]
        }
    ],
    "total": 7
}

学生变动

学生迁回

获取变动学生列表

检索变动学生

获取学生历史变动记录

results matching ""

No results matching ""

results matching ""

No results matching ""