查询学科列表

使用场景：查询学校的学科列表

权限说明

权限项 说明 备注
应用是否需要申请白名单 不需要
用户凭证 不支持
机构凭证 支持 -

请求方式： GET（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/list

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
page_index int32 否 第几页
page_size int32 否 每页数量

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
data_list []object 学科列表
data_list.id uint32 学科id
data_list.name string 学科名
data_list.is_system uint32 是否系统学科 0-不是 1-是
data_list.is_hide uint32 是否隐藏 0-显示 1-隐藏
page_info 页码
page_info.total uint32 总数
page_info.page_index uint32 第几页
page_info.page_size uint32 每页数量

请求示例:

GET https://oapi.epaas.qq.com/subject/list?access_token=ACCESS_TOKEN&page_index=1&page_size=30

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
            "id": 1,
            "name": "语文",
            "is_system": 1,
            "is_hide": 0
        },
        {
            "id": 2,
            "name": "数学",
            "is_system": 1,
            "is_hide": 0
        }
    ],
    "page_info": {
        "total": 33,
        "page_index": 1,
        "page_size": 2
    }
}

修改学科

使用场景：学校修改学科

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要
用户凭证 不支持
机构凭证 支持 -

请求方式： POST（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/update

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
subjects []object 否 学科列表
subjects.id int32 是 学科id
subjects.is_hide int32 否 是否隐藏 0-显示 1-隐藏

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容

请求示例:

POST https://oapi.epaas.qq.com/subject/update?access_token=ACCESS_TOKEN

{
    "subjects": [
        {
            "id": 1,
            "is_hide": 1
        },
        {
            "id": 2,
            "is_hide": 0
        }
    ]
}

返回结果：

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

查询教研组长列表

使用场景：查询学校的教研组长列表

权限说明

权限项 说明 备注
应用是否需要申请白名单 不需要
用户凭证 不支持
机构凭证 支持 -

请求方式： GET（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/leader/list

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
page_index int32 否 第几页
page_size int32 否 每页数量

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
data_list []object 学科列表
data_list.id uint32 学科id
data_list.name string 学科名
data_list.data_list 教研组长列表
data_list.data_list.userid string 用户id
data_list.data_list.name string 用户名称
page_info 页码
page_info.total uint32 总数
page_info.page_index uint32 第几页
page_info.page_size uint32 每页数量

请求示例:

GET https://oapi.epaas.qq.com/subject/leader/list?access_token=ACCESS_TOKEN&page_index=1&page_size=30

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "data_list": [
        {
            "id": 1,
            "name": "语文",
            "data_list": [
                {
                    "userid": "3726977225",
                    "name": "测试"
                }
            ]
        },
        {
            "id": 4,
            "name": "物理",
            "data_list": []
        }
    ],
    "page_info": {
        "total": 31,
        "page_index": 1,
        "page_size": 2
    }
}

查询教研组长详情

使用场景：查询单个学科的教研组长详情

权限说明

权限项 说明 备注
应用是否需要申请白名单 不需要
用户凭证 不支持
机构凭证 支持 -

请求方式： GET（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/leader/get

请求参数:

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

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
id uint32 学科id
data_list []object 教研组长列表
data_list.userid string 用户id
data_list.name string 用户名称
data_list.phone string 手机号

请求示例:

GET https://oapi.epaas.qq.com/subject/leader/get?access_token=ACCESS_TOKEN&id=1

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "id": 1,
    "data_list": [
        {
            "userid": "3726977225",
            "name": "测试",
            "phone": "182****1943"
        }
    ]
}

设置学科的教研组长

使用场景：设置学科的教研组长 (覆盖更新)

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要
用户凭证 不支持
机构凭证 支持 -

请求方式： POST（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/leader/set

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
id int32 是 学科id
userid_list []string 否 用户id列表

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
id int32 学科id
userid_list []string 用户id列表

请求示例:

POST https://oapi.epaas.qq.com/subject/leader/set?access_token=ACCESS_TOKEN

{
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}

添加学科的教研组长

使用场景：添加学科的教研组长

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要
用户凭证 不支持
机构凭证 支持 -

请求方式： POST（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/leader/add

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
id int32 是 学科id
userid_list []string 否 用户id列表

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
id int32 学科id
userid_list []string 用户id列表

请求示例:

POST https://oapi.epaas.qq.com/subject/leader/add?access_token=ACCESS_TOKEN

{
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}

删除学科的教研组长

使用场景：删除学科的教研组长

权限说明

权限项 说明 备注
应用是否需要申请白名单 需要
用户凭证 不支持
机构凭证 支持 -

请求方式： POST（HTTPS）

请求地址：https://oapi.epaas.qq.com/subject/leader/delete

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
id int32 是 学科id
userid_list []string 否 用户id列表

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
id int32 学科id
userid_list []string 用户id列表

请求示例:

POST https://oapi.epaas.qq.com/subject/leader/delete?access_token=ACCESS_TOKEN

{
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "id": 1,
    "userid_list": [
        "3726977225",
        "3733213929"
    ]
}
© 1998 - 2021 Tencent Inc. All Rights Reserved all right reserved，powered by ePaaS.更新时间： 2023-10-18 10:49:35

results matching ""

    No results matching ""

    results matching ""

      No results matching ""