获取学科元数据列表

说明

调用本接口获取学科元数据列表。
服务地址：https://oapi.dingtalk.com

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。详情请参考权限申请和基础概念。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	是	开发者后台申请	调试
第三方企业应用	是	开发者后台申请	调试
第三方个人应用	否	—	—

请求参数

Query 参数

access_token

string

必需

调用服务端接口的授权凭证。企业内部应用可通过调用access_token接口获得。第三方企业应用可通过调用get_corp_token接口获得。

示例值:

Be3xxxx

Body 参数application/json

cursor

number

游标，从0开始。

必需

level

number

层级。

可选

operator_userid

string

必需

用户的userid。

parent_id

number

父ID。

可选

period_code

string

必需

学段编码。可以通过调用获取学段元数据列表获取。

data_order_type

number

排序依赖字段类型。

可选

area_code

string

地区编码。

必需

size

number

每页数据条数。

必需

sort_type

number

可选

排序方式：0：正序1：倒序

示例

{
  "cursor": 0,
  "data_order_type": 0,
  "sort_type": 1,
  "size": 2,
  "level": 2,
  "operator_userid": "user0012",
  "period_code": "primary_school",
  "parent_id": 11,
  "area_code": "CN"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

success

boolean

是否调用成功。

可选

errcode

number

返回码。

可选

errmsg

string

返回码描述。

可选

result

object

返回结果。

可选

next_cursor

number

下一页游标。

可选

has_more

boolean

是否还有更多数据。

可选

list

array [object {7}]

学科元数据列表。

可选

total_count

number

总数据条数。

可选

示例

{
  "success": true,
  "errcode": 0,
  "errmsg": "string",
  "result": {
    "next_cursor": 0,
    "has_more": true,
    "list": [
      {
        "id": 0,
        "area_code": "string",
        "period_code": "string",
        "parent_id": 0,
        "level": 0,
        "subject_name": "string",
        "subject_code": "string"
      }
    ],
    "total_count": 0
  }
}

说明#

权限#

请求参数

示例代码

返回响应

说明

权限