top
关闭

开发者登录

学校信息类接口

主要使用场景:学校信息类接口

1、学校搜索列表

基础 需要授权

根据各种条件查询学校组织

前置条件

获取接口访问令牌:accessToken

请求说明

urlhttps://api.wuhaneduyun.cn/user/openapi/org/query-org
请求方式post
是否需要鉴权
请求数限制
接口方向第三方应用->开放平台

参数说明

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

1

org_id

可选

String

-

学校组织id

2

org_name

可选

String

-

学校组织名称

3

org_type

可选

String

-

组织类型,多个使用英文逗号分隔(1机构,2学校)

4

province_code

可选

String

-

所属地理省份

5

city_code

可选

String

-

所属地理市

6

area_code

可选

String

-

所属地理区

7

status

可选

String

-

状态,多个使用英文逗号分隔(0:组织未激活,1:正常)

8

platform_code

可选

String

-

实体平台编码

9

v_platform_code

可选

String

-

虚拟平台编码

10

certification

可选

String

-

认证(0:未认证,1:已认证)

11

org_category

可选

String

-

组织的类别 系统字段说明

12

org_level_code

可选

String

-

行政区划(行政上所属的区域)

13

org_parent_id

可选

String

-

上级机构id(查的是直属下级单位)

14

org_parent_ids

可选

String

-

附属上级机构id(查的是所有的下级单位,包括跨行政级别的下级单位组织)

15

flag

可选

String

-

标记,多个使用英文逗号分隔,默认正常和演示(0:正常,1:演示,2:测试)

16

org_record_status

可选

String

-

教育局备案状态,0:未备案,1:已备案

17

page

可选

Int

-

查询页

18

page_size

可选

Int

-

查询条数,默认10,上限100

19

sort

可选

string

-

默认为空,传time : 创建时间倒叙

返回说明

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

1

code

必选

string

-

结果编码,000000:成功, 100001:失败

2

message

必选

string

-

结果描述

3

result

必选

json[]

-

json数组

3.1

page

必选

int

-

当前页

3.2

page_size

必选

int

-

查询量

3.3

count

必选

int

-

总数

3.4

lists

必选

array

-

数组对象

3.4.1

org_id

必选

string

-

组织id

3.4.2

org_name

必选

string

-

组织名称

3.4.3

org_type

必选

string

-

组织类型

示例

**请求示例**
{
   "org_name" : "小学",
   "org_type":"2",
   "org_category":"0"
}
**返回示例:**
{
  "code": "000000",
  "message": "成功",
  "result": {
    "page": 1,
    "page_size": 10,
    "count": 2,
    "lists": [
      {
        "org_id": "xxx",
        "org_name": "xx小学",
        "org_type": 2
      },
      {
        "org_id": "xxx",
        "org_name": "xx小学",
        "org_type": 2
      }
    ]
  }
}