{"openapi": "3.1.0", "info": {"title": "EduKB 教育数据知识引擎", "version": "1.1.4", "description": "中国K12学校名录 / 高校 / CWUR 全球排名 / 本科专业目录的只读查询接口，另含数字员工与 MCP 智能体入口。全部 GET + CORS 全开 + 每分钟 120 次限流 + 30 秒缓存（命中带 X-Cache: HIT）。浏览器检索与 SQL：https://e.aixgn.cn/edukb/data/edukb"}, "servers": [{"url": "/edukb"}], "paths": {"/api/stats": {"get": {"summary": "覆盖度统计", "responses": {"200": {"description": "各表条数与分面"}}}}, "/api/schools": {"get": {"summary": "学校检索（203,431 条）", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "校名或学校代码包含匹配"}, {"name": "province", "in": "query", "schema": {"type": "string"}, "description": "省份，如 福建"}, {"name": "city", "in": "query", "schema": {"type": "string"}, "description": "地级市，如 福州市"}, {"name": "county", "in": "query", "schema": {"type": "string"}, "description": "县区，如 鼓楼区"}, {"name": "level", "in": "query", "schema": {"type": "string"}, "description": "小学/初中/高中/九年一贯/中职/特教/幼儿园/其他/高等学校"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20, "maximum": 200}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "{total, limit, offset, items}"}}}}, "/api/cities": {"get": {"summary": "省/市/县区索引（带学校数）", "parameters": [{"name": "province", "in": "query", "schema": {"type": "string"}, "description": "给省份则同时返回该省 cities 与 counties"}], "responses": {"200": {"description": "{total_cities, items}"}}}}, "/api/schools/{code}": {"get": {"summary": "学校详情", "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}}], "responses": {"200": {"description": "学校对象"}, "404": {"description": "不存在"}}}}, "/api/universities": {"get": {"summary": "高校检索（5,065 所，含中文名）", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}, "description": "中英文名包含匹配"}, {"name": "country", "in": "query", "schema": {"type": "string"}, "description": "China / USA 等"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "ok"}}}}, "/api/rankings": {"get": {"summary": "榜单查询（CWUR 2026，2,000 条）", "parameters": [{"name": "country", "in": "query", "schema": {"type": "string"}}, {"name": "rank_min", "in": "query", "schema": {"type": "integer"}}, {"name": "rank_max", "in": "query", "schema": {"type": "integer"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "ok"}}}}, "/api/universities/{slug}": {"get": {"summary": "高校详情"}}, "/api/majors": {"get": {"summary": "专业目录（839 个 / 90 专业类）", "parameters": [{"name": "q", "in": "query", "schema": {"type": "string"}}, {"name": "discipline", "in": "query", "schema": {"type": "string"}, "description": "学科门类，如 工学"}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20}}, {"name": "offset", "in": "query", "schema": {"type": "integer", "default": 0}}], "responses": {"200": {"description": "ok"}}}}, "/api/export.csv": {"get": {"summary": "按筛选导出 CSV", "parameters": [{"name": "table", "in": "query", "schema": {"type": "string", "enum": ["schools", "universities", "rankings", "majors"]}}, {"name": "q", "in": "query", "schema": {"type": "string"}}, {"name": "province", "in": "query", "schema": {"type": "string"}}, {"name": "level", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "text/csv"}}}}, "/api/grid": {"get": {"summary": "省份×学段 交叉分布", "parameters": [{"name": "level", "in": "query", "description": "按某学段取值排序"}]}}, "/api/rank_stats": {"get": {"summary": "排名分档分布", "parameters": [{"name": "country", "in": "query", "description": "国家代码，默认 CN"}]}}, "/api/employee/ask": {"post": {"summary": "数字员工问答", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"q": {"type": "string"}}}}}}, "responses": {"200": {"description": "answer + evidence"}}}}, "/mcp": {"post": {"summary": "MCP JSON-RPC（智能体接入）"}}}}