K12服务体系技术规范 API接口说明

公共-获取学生列表

URL:/common/student_list

请求方式:GET

Headers:

参数 说明
Authorization access_token访问令牌

参数:

名称 必选 类型 说明
school_code true char 学校编码
grade_id false int 年级id
class_id false int 班级id
page false int 当前页数 默认为1
per_page false int 获取每页显示数量 默认为20,上限999

响应:

名称 类型 说明
status int 状态
msg char 返回信息
open_id char 用户唯一标识id
sequence_no char 学生序号
name char 姓名
sex int 0:女 1:男
class_id int 班级id
page int 当前页号
total int 记录总数

JSON示例:

成功返回

{
    "list":[
        {
            "open_id": "6E218369-15F2-4E98-8735-2A8AF7E26479",
            "account": "100101",
            "sequence_no": "100101",
            "name": "陈聪",
            "sex": 1,
            "class_id": 1,
        },
        {
            "open_id": "6E218369-15F2-4E98-8735-2A8AF7E26479",
            "account": "100101",
            "sequence_no": "100102",
            "name": "陈瑛",
            "sex": 0,
            "class_id": 1,
        }
    ],
    "pagenation": {
        "page": 1,
        "total": 29
    }
}

失败返回

{
    "status": <ErrorCode>,
    "msg": <ErrorMessage>
}