名校列表 - 学科网接口

请求参数

Header 参数

Xop-App-Id

string

可选

示例值:

103231681885018300

Xop-Nonce

string

可选

示例值:

fee892b36ac342439d493c1e8e306ed2

Xop-Timestamp

string

可选

示例值:

1682495577

Xop-Sign

string

可选

示例值:

45db1b19b8c72a2bc61bab5a5864923472c7a55e

Body 参数application/json

tag_ids

array[string]

学校标签ID列表，可传入多个值，只支持：23 省重点、24 百强校、26 市重点，默认为全部名校

必需

keywords

string

学校名称关键字

必需

stage

string

学段ID,传字符串ID或者数字ID皆可。PRIMARY=2(小学)，JUNIOR_MIDDLE=3（初中），SENIOR_MIDDLE=4（高中）。请参考学段相关的API获取更多信息。

必需

page_index

integer

当前页码（从1开始）

必需

area_id

string

地区ID（省市县）

必需

page_size

integer

必需

示例

{"stage": "2"}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi.xkw.com/xopqbm/orgs/famous-schools' \
--header 'Xop-App-Id: 103231681885018300' \
--header 'Xop-Nonce: fee892b36ac342439d493c1e8e306ed2' \
--header 'Xop-Timestamp: 1682495577' \
--header 'Xop-Sign: 45db1b19b8c72a2bc61bab5a5864923472c7a55e' \
--header 'Content-Type: application/json' \
--data-raw '{"stage": "2"}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

page_index

integer

必需

page_size

integer

必需

total_size

integer

必需

total_page

integer

必需

items

array [object {5}]

必需

示例

{"code":2000000,"msg":"OK","data":{"page_index":1,"page_size":10,"total_size":330,"total_page":33,"items":[{"id":9,"name":"北京景山学校","stage_sum":14,"area_id":"110101","tags":[{"id":24,"name":"百强名校"}]},{"id":20,"name":"北京市第一六六中学","stage_sum":14,"area_id":"110101","tags":[{"id":23,"name":"省级重点"}]},{"id":32,"name":"北京市第五中学分校","stage_sum":6,"area_id":"110101","tags":[{"id":26,"name":"市级重点"}]},{"id":148,"name":"北京市文汇中学","stage_sum":6,"area_id":"110101","tags":[{"id":26,"name":"市级重点"}]},{"id":194,"name":"北京市第十四中学","stage_sum":14,"area_id":"110102","tags":[{"id":23,"name":"省级重点"}]},{"id":197,"name":"北京市育才学校","stage_sum":14,"area_id":"110102","tags":[{"id":23,"name":"省级重点"}]},{"id":213,"name":"北京工业大学附属中学","stage_sum":14,"area_id":"110105","tags":[{"id":23,"name":"省级重点"}]},{"id":216,"name":"北京市东方德才学校","stage_sum":14,"area_id":"110105","tags":[{"id":26,"name":"市级重点"}]},{"id":233,"name":"北京市和平街第一中学","stage_sum":14,"area_id":"110105","tags":[{"id":23,"name":"省级重点"}]},{"id":244,"name":"北京市陈经纶中学嘉铭分校","stage_sum":6,"area_id":"110105","tags":[{"id":26,"name":"市级重点"}]}]}}