查询学科列表

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

权限说明

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

请求方式： GET（HTTPS）

请求地址：https://jz.hasmartedu.com/oapi/subject/list

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
page_index int32 否 第几页，不传默认第一页
page_size int32 否 每页数量，不传默认1000
is_all int32 否 0-不返回隐藏的 1-返回全部，不传默认0

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
data_list []object 学科列表
data_list.id uint32 学科id
data_list.code string 学科编码，系统学科编码参考系统学科编码表 ，自定义学科编码从P001开始数字依次递增
data_list.name string 学科名
data_list.section []uint32 学段说明
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://jz.hasmartedu.com/oapi/subject/list?access_token=ACCESS_TOKEN&page_index=1&page_size=30&is_all=1

返回结果：

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

新增学科

使用场景：学校新增学科

权限说明

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

请求方式： POST（HTTPS）

请求地址：https://jz.hasmartedu.com/oapi/subject/create

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
subjects []object 是 学科列表
subjects.name string 是 学科名称 （不能与系统学科is_system=1学科重名）
subjects.is_hide int32 否 是否隐藏 0-显示 1-隐藏，不传默认显示
subjects.section []int32 是 学段说明

返回参数:

参数 类型 说明
errcode int 返回码，0为正常
errmsg string 对返回码的文本描述内容
subjects []object 学科列表
subjects.code string 学科编码，系统学科编码参考系统学科编码表 ，自定义学科编码从P001开始数字依次递增
subjects.name string 学科名

请求示例:

POST https://jz.hasmartedu.com/oapi/subject/create?access_token=ACCESS_TOKEN

{
  "subjects": [
    {
      "is_hide": 1,
      "name": "日语",
      "section": [1,2,3]
    },
    {
      "is_hide": 0,
      "name": "溜冰",
      "section": [1,2,3]
    }
  ]
}

返回结果：

{
    "errmsg": "ok",
    "errcode": 0,
    "subjects": [
      {
        "code": "C001",
        "name": "日语"
      },
      {
        "code": "C002",
        "name": "溜冰"
      }
    ]
}

修改学科

使用场景：学校修改学科

权限说明

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

请求方式： POST（HTTPS）

请求地址：https://jz.hasmartedu.com/oapi/subject/update

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
subjects []object 是 学科列表
subjects.code string 是 学科编码，系统学科编码参考系统学科编码表 ，自定义学科编码从P001开始数字依次递增
subjects.name string 否 学科名称
subjects.is_hide int32 否 是否隐藏 0-显示 1-隐藏
subjects.section []int32 否 学段说明

返回参数:

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

请求示例:

POST https://jz.hasmartedu.com/oapi/subject/update?access_token=ACCESS_TOKEN

{
    "subjects": [
        {
            "code": "C001",
            "is_hide": 1,
            "name": "日语"
        },
        {
            "code": "C002",
            "is_hide": 0
        }
    ]
}

返回结果：

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

删除学科

使用场景：学校删除学科

权限说明

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

请求方式： POST（HTTPS）

请求地址：https://jz.hasmartedu.com/oapi/subject/delete

请求参数:

参数 类型 必填 说明
access_token string 是 接口调用凭证
codes []string 是 学科编码，系统学科编码参考系统学科编码表 ，自定义学科编码从P001开始数字依次递增

返回参数:

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

请求示例:

POST https://jz.hasmartedu.com/oapi/subject/update?access_token=ACCESS_TOKEN

{
    "codes": ["P001","P002","P003"]
}

返回结果：

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

查询教研组长列表

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

权限说明

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

请求方式： GET（HTTPS）

请求地址：https://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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://jz.hasmartedu.com/oapi/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.更新时间： 2025-01-09 17:17:38

results matching ""

    No results matching ""

    results matching ""

      No results matching ""