top
关闭

开发者登录

资源编目API

主要使用场景:主要开放了教学资源编目的基础信息API

1、获取学段列表

基础 需要授权

根据教材数据关联获取学段信息。

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://api.wuhaneduyun.cn/rescBase/queryPeriods?accessToken=ACCESS_TOKEN
请求方式post
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

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

1

platformCode

必选

String

对应平台编码

2

subjectId

可选

string

学科ID

3

gradeId

可选

string

年级ID

4

volumeId

可选

string

册别ID

返回说明

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

1

retCode

必选

String

6

返回码

2

retDesc

必选

String

100

返回码描述

3

periodList

必选

Json对象

-

学段列表

3.1

periodId

必选

String

64

学段ID

3.2

periodName

必选

String

50

学段名称

3.3

sortNum

可选

Int

-

排序字段

示例

请求报文:
{
	"platformCode":"999999",
    "subjectId":"sub",
    "gradeId":"gra",
    "volumeId":"vol"
}
    应答报文:
 {
  "retCode": "000000",
  "retDesc": "success",
  "periodList": [
    {
      "periodId": "xq",
      "periodName": "学前",
      "sortNum": 1
    },
    {
      "periodId": "xx",
      "periodName": "小学",
      "sortNum": 2
    },
    {
      "periodId": "cz",
      "periodName": "初中",
      "sortNum": 3
    },
    {
      "periodId": "pg",
      "periodName": "高中",
      "sortNum": 4
    },
    {
      "periodId": "zz",
      "periodName": "中职",
      "sortNum": 5
    }
  ]
}