全国大学高校专业数据
GET
https://api.gugudata.com/metadata/ceemajor
GET /metadata/ceemajor业务说明
请求参数
| 参数 | 位置 | 类型 | 必填 | 真实默认值 | 说明 |
|---|---|---|---|---|---|
| appkey | query | string | 否 | 无 | 付费后获取的 APPKEY |
| keywords | query | string | 否 | 无 | 专业检索关键词，包含匹配专业名称、学科、专业简介或课程名称；为空时返回分页专业列表。 |
| code | query | string | 否 | 无 | 既有专业代码精确筛选参数；与 keywords 同时提供时共同限定结果。 |
| pageIndex | query | integer | 否 | 1 | 页码，第几页数据，第一页从 1 开始 |
| pageSize | query | integer | 否 | 10 | 每页数据量，参数最大值为 20 |
独立请求示例
{
"keywords": "计算机",
"pageIndex": 1,
"pageSize": 10
}返回契约
application/json{
"type": "object",
"required": [
"DataStatus",
"Data"
],
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "array",
"items": {
"type": "object",
"required": [
"DataId",
"EducationLevel",
"DisciplinaryCategory",
"DisciplinarySubCategory",
"MajorCode",
"MajorName",
"MajorIntroduction",
"Courses",
"GraduateScale",
"MaleFemaleRatio",
"RecommendSchools",
"JobWorkingDetails",
"LimitYear",
"Degree",
"SpecialSchools",
"DataUpdatedFrom"
],
"additionalProperties": false,
"properties": {
"DataId": {
"type": "string",
"description": "稳定资料标识。"
},
"EducationLevel": {
"type": "string",
"description": "学历层次"
},
"DisciplinaryCategory": {
"type": "string",
"description": "学科门类"
},
"DisciplinarySubCategory": {
"type": "string",
"description": "学科专业类"
},
"MajorCode": {
"type": "string",
"description": "专业代码"
},
"MajorName": {
"type": "string",
"description": "专业名称"
},
"MajorIntroduction": {
"type": "string",
"description": "专业介绍"
},
"Courses": {
"type": "array",
"items": {
"type": "object",
"required": [
"CourseName",
"CourseDifficulty"
],
"properties": {
"CourseName": {
"type": "string",
"description": "开设课程名称"
},
"CourseDifficulty": {
"type": "string",
"description": "开设课程难度"
}
},
"description": "课程对象数组，含 CourseName 和 CourseDifficulty；缺少资料时保留空数组。"
},
"description": "课程对象数组，含 CourseName 和 CourseDifficulty；缺少资料时保留空数组。"
},
"GraduateScale": {
"type": "string",
"description": "全国普通高校毕业生规模 （概略数据）"
},
"MaleFemaleRatio": {
"type": "string",
"description": "男女比例 （概略数据）"
},
"RecommendSchools": {
"type": "array",
"items": {
"type": "string",
"description": "推荐院校列表"
},
"description": "推荐院校列表"
},
"JobWorkingDetails": {
"type": "array",
"items": {
"type": "string",
"description": "专业相关就业去向资料，用于职业方向参考，不代表就业承诺。"
},
"description": "专业相关就业去向资料，用于职业方向参考，不代表就业承诺。"
},
"LimitYear": {
"type": [
"string",
"null"
],
"description": "专业学制资料，按原文字展示；具体培养年限以招生院校说明为准。"
},
"Degree": {
"type": [
"string",
"null"
],
"description": "专业相关的授予学位资料，用于展示培养结果，不代表个人已获得该学位。"
},
"SpecialSchools": {
"type": [
"array",
"null"
],
"items": {
"type": "string",
"description": "专业顶尖高校"
},
"description": "专业顶尖高校"
},
"DataUpdatedFrom": {
"type": [
"string",
"null"
],
"description": "来源可用补充资料时间，未知时为空；不使用响应时间替代。"
}
},
"description": "专业对象数组；来源确认无匹配时为空数组。"
},
"description": "专业对象数组；来源确认无匹配时为空数组。"
}
}
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"$ref": "#/components/schemas/CommonResponse"
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "专业对象数组；来源确认无匹配时为空数组。"
}
}
}application/json{
"type": "object",
"properties": {
"DataStatus": {
"type": "object",
"required": [
"RequestParameter",
"StatusCode",
"StatusDescription",
"ResponseDateTime",
"DataTotalCount"
],
"properties": {
"RequestParameter": {
"type": "string",
"description": "请求参数，一般用于调试"
},
"StatusCode": {
"type": "integer",
"description": "接口返回状态码"
},
"StatusDescription": {
"type": "string",
"description": "接口返回状态说明"
},
"ResponseDateTime": {
"type": "string",
"description": "接口数据返回时间"
},
"DataTotalCount": {
"type": "integer",
"description": "此条件下的总数据量，一般用于分页计算"
}
}
},
"Data": {
"type": "null",
"description": "专业对象数组；来源确认无匹配时为空数组。"
}
}
}业务状态与 HTTP 状态
| 业务码 | 含义 | 说明 |
|---|---|---|
| 100 | 成功 | HTTP 200；仍应检查业务状态。 |
| 501 | 参数错误 | HTTP 400 |
| 900 | 依赖失败 | HTTP 500 |
OpenAPI：https://www.gugudata.com/openapi/gugudata.openapi.3.1.json
请求参数
Query 参数
请求示例代码
返回响应
扫码咨询客服修改于 2026-11-09 03:49:13