top
关闭

开发者登录

系统字典类

主要使用场景:系统字典类

1、查询自定义学科列表

基础 需要授权

查询自定义学科列表

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://api.wuhaneduyun.cn/user/openapi/subject/get-custom-subject?accessToken={{accessToken}}
请求方式get
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

序号 字段名 约束 类型 长度 说明

1

top_org_id

必选

string

学校编号 必传

2

school_period

可选

string

学段类型 以,连接 不传查所有学段

3

page

可选

string

页码 不传默认1

4

page_size

可选

int

每页查询数量 不传默认100

返回说明

序号 字段名 约束 类型 长度 说明

1

code

必选

string

结果编码

2

message

必选

string

结果描述

3

result

必选

json

结果对象

3.1

count

必选

string

学科数量

3.2

page

必选

string

当前页码

3.3

page_size

必选

string

每页数量

3.4

list

必选

json

学科列表

3.4.1

subject_id

必选

string

学科编号

3.4.2

parent_subject_id

必选

string

父级学科(预留)

3.4.3

org_id

必选

string

学校id

3.4.4

school_period

必选

string

学段,多个逗号分隔

3.4.5

subject_name

必选

string

学科名字

3.4.6

subject_alias

必选

string

学科别名

3.4.7

subject_type

必选

string

学科类型

3.4.8

status

必选

int

状态

3.4.9

createtime

必选

int

创建时间

3.4.10

updatetime

必选

int

更新时间

示例

请求示例
https://api.wuhaneduyun.cn/user/openapi/subject/get-custom-subject?top_org_id=***&school_period=***&accessToken={{accessToken}}

返回示例
{
  "code": "000000",
  "message": "查询成功",
  "result": {
    "count": 8,
    "page": 1,
    "page_size": 3,
    "list": [
      {
        "org_id": "012b5b648d8211e9a0210200f73e4533",
        "status": 0,
        "createtime": 1583458216,
        "subject_id": "08d1d0ba5f4a11eabcce0200f7010548",
        "updatetime": 1583460162,
        "introduction": "",
        "subject_name": "自定义学科1",
        "subject_type": 2,
        "platform_code": "",
        "school_period": "0,1",
        "subject_alias": "自定义学科1",
        "parent_subject_id": ""
      },
      {
        "org_id": "012b5b648d8211e9a0210200f73e4533",
        "status": 0,
        "createtime": 1619160997,
        "subject_id": "0c89cee0a40111eb99042ad18a2581e3",
        "updatetime": 1626412070,
        "introduction": "",
        "subject_name": "理科综合",
        "subject_type": 2,
        "platform_code": "888880",
        "school_period": "1,2",
        "subject_alias": "理综",
        "parent_subject_id": ""
      },
      {
        "org_id": "012b5b648d8211e9a0210200f73e4533",
        "status": 0,
        "createtime": 1619161007,
        "subject_id": "12273720a40111eb80af2ad18a2581e3",
        "updatetime": 1626412092,
        "introduction": "",
        "subject_name": "文科综合",
        "subject_type": 2,
        "platform_code": "888880",
        "school_period": "1,2",
        "subject_alias": "文综",
        "parent_subject_id": ""
      }
    ]
  }
}