根据下图求角 A。
", "images": [ "https://example.com/question-a.png" ] }, "exam2": { "content_type": "markdown", "content": "根据图形计算角 A。", "images": [ "https://example.com/question-b.png" ] } } } } } } }, "security": [ { "AppKeyHeader": [] }, { "AppKeyCompatHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyQuery": [] }, { "AppKeyBearer": [] } ], "x-apifox-folder": "教育\\/高考" } }, "/fund/basic/index": { "get": { "summary": "指数基金业绩", "description": "查询指数基金净值与区间收益。\n详情页：https://www.gugudata.com/api/details/fundbasicindex", "operationId": "get_fundbasicindex", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundbasicindex" }, "x-gugudata-api-identity": "fundbasicindex", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "501", "title": "参数错误", "remark": "" }, { "code": "502", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "503", "title": "账号欠费", "remark": "" }, { "code": "504", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "505", "title": "调用额度不足", "remark": "" }, { "code": "901", "title": "数据服务暂时不可用", "remark": "请稍后重试；如持续失败，请联系技术支持。" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" }, "DataFetchedAt": { "type": "string", "format": "date-time" }, "LatestNetValueDate": { "type": "string", "format": "date" }, "EarliestNetValueDate": { "type": "string", "format": "date" }, "IsFallbackData": { "type": "boolean" }, "InvalidRowCount": { "type": "integer", "minimum": 0 }, "DuplicateRowCount": { "type": "integer", "minimum": 0 }, "Warnings": { "type": "array", "items": { "type": "string" } } }, "description": "接口业务状态信息。", "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount", "DataFetchedAt", "LatestNetValueDate", "EarliestNetValueDate", "IsFallbackData", "InvalidRowCount", "DuplicateRowCount", "Warnings" ] }, "Data": { "type": "array", "items": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "指数基金的 6 位代码，保留前导零" }, "FundName": { "type": "string", "description": "指数基金名称，用于识别基金份额和跟踪产品" }, "NetAssetValue": { "type": [ "number", "null" ], "description": "基金公司最近一次公布的单位净值；暂不可用时为 null" }, "TimeKey": { "type": [ "string", "null" ], "description": "最近单位净值对应的日期，通常格式为 yyyy-MM-dd；暂不可用时为 null" }, "DayGrowthRate": { "type": [ "number", "null" ], "description": "最近单位净值相对上一净值日的增长率，单位为百分比；暂不可用时为 null" }, "WeekGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 1 周收益率，单位为百分比" }, "MonthGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 1 月收益率，单位为百分比" }, "ThreeMonthGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 3 月收益率，单位为百分比" }, "SixMonthGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 6 月收益率，单位为百分比" }, "YearGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 1 年收益率，单位为百分比" }, "TwoYearGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 2 年收益率，单位为百分比" }, "ThreeYearGrowthRate": { "type": [ "number", "null" ], "description": "截至 TimeKey 的近 3 年收益率，单位为百分比" }, "ThisYearGrowthRate": { "type": [ "number", "null" ], "description": "从本年度首个净值日至 TimeKey 的收益率，单位为百分比" }, "SinceEstablishmentGrowthRate": { "type": [ "number", "null" ], "description": "从基金成立日至 TimeKey 的累计收益率，单位为百分比" }, "Fee": { "type": [ "number", "null" ], "description": "基金费率数值；暂不可用时为 null，具体费率以基金销售规则为准" }, "MinPurchaseAmount": { "type": [ "string", "null" ], "description": "基金最低购买金额说明，可能包含金额单位或文字条件；暂不可用时为 null" }, "TrackingTarget": { "type": "string", "deprecated": true, "description": "当前 index 筛选范围。" }, "TrackingMethod": { "type": "string", "deprecated": true, "description": "当前 indicator 筛选范围。" }, "IndexCategory": { "type": "string", "description": "本条结果对应的指数分类，与请求参数 index 的筛选语义一致" }, "FundType": { "type": "string", "description": "本条结果对应的指数基金类型，与请求参数 indicator 的筛选语义一致" } }, "required": [ "FundCode", "FundName", "TrackingTarget", "TrackingMethod", "IndexCategory", "FundType" ], "additionalProperties": false }, "description": "指数基金业绩数据列表。" } }, "description": "咕咕数据标准响应结构。", "additionalProperties": false } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "数据服务暂时不可用，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "基金数据暂时不可用，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/basic/index/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "index", "in": "query", "required": true, "description": "必填。指数类别，仅支持：全部、沪深指数、行业主题、大盘指数、中盘指数、小盘指数、股票指数、债券指数；必须传完整中文名称", "schema": { "type": "string", "enum": [ "全部", "沪深指数", "行业主题", "大盘指数", "中盘指数", "小盘指数", "股票指数", "债券指数" ] }, "example": "沪深指数" }, { "name": "indicator", "in": "query", "required": true, "description": "必填。指数基金类型，仅支持：全部、被动指数型、增强指数型；必须传完整中文名称", "schema": { "type": "string", "enum": [ "全部", "被动指数型", "增强指数型" ] }, "example": "被动指数型" }, { "name": "pageIndex", "in": "query", "required": false, "description": "可选。页码，从 1 开始；仅在 pageSize 大于 0 时生效。", "schema": { "type": "integer", "minimum": 1, "default": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "每页数量为 1 至 500；传 0 时返回全部数据。", "schema": { "type": "integer", "minimum": 0, "maximum": 500, "default": 0 }, "example": 100 }, { "name": "sortBy", "in": "query", "required": false, "schema": { "type": "string", "default": "source", "enum": [ "source", "fundCode", "timeKey", "netAssetValue", "dayGrowthRate", "weekGrowthRate", "monthGrowthRate", "threeMonthGrowthRate", "sixMonthGrowthRate", "yearGrowthRate", "twoYearGrowthRate", "threeYearGrowthRate", "thisYearGrowthRate", "sinceEstablishmentGrowthRate", "fee" ] } }, { "name": "sortOrder", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "asc", "desc" ], "default": "asc" } } ], "x-apifox-folder": "商业\\/分析", "security": [ { "AppKeyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ] } }, "/fund/basicinfo": { "get": { "summary": "基金基本信息", "description": "分页获取基金代码、名称、类型与拼音\n接口标签：基金目录、基础信息、分页查询、基金、基金代码\n接口特性：\n- 分页返回基金代码、简称、全称、基金类型和名称拼音等基础目录信息\n- 可作为基金搜索框、选择器、代码校验和其他基金接口参数准备的数据源\n- DataTotalCount 表示当前基金目录的全部记录数，不是当前页实际返回条数\n- pageIndex 从 1 开始，pageSize 每页最多返回 20 条记录\n- 结果按基金代码整理，同一基金代码只保留一条有效基础信息记录\n- 基金代码始终按字符串返回并保留前导零，接入方不应转换为整数\n- 当外部基础目录暂时不可用时，服务会使用可用的基金元数据保证目录稳定性\n- 本接口不返回净值、价格、收益率或申赎状态，行情数据应使用对应基金接口\n详情页：https://www.gugudata.com/api/details/fundinfolist", "operationId": "get_fundinfolist", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundinfolist" }, "x-gugudata-api-identity": "fundinfolist", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "基金的 6 位代码，保留前导零，可作为其他基金接口的 symbol 参数" }, "FundShort": { "type": "string", "description": "基金简称，适合在空间有限的列表或选择器中展示" }, "FundName": { "type": "string", "description": "基金完整名称，用于基金详情和精确检索展示" }, "FundType": { "type": "string", "description": "基金所属类型，例如股票型、混合型、债券型或指数型等" }, "FundPinYin": { "type": "string", "description": "基金名称对应的拼音检索值，可用于拼音或首字母搜索" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/basicinfo/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "pageIndex", "in": "query", "required": false, "description": "可选。分页页码，从 1 开始；第一页传 1，第二页传 2，以此类推", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "可选。每页返回条数，取值范围为 1~20；未传时默认 10", "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/fund-etf-open-ranking-list": { "get": { "summary": "场内基金业绩排行", "description": "查询场内基金多周期收益排行。\n详情页：https://www.gugudata.com/api/details/fundetfopenrankinglist", "operationId": "get_fundetfopenrankinglist", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundetfopenrankinglist" }, "x-gugudata-api-identity": "fundetfopenrankinglist", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。", "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ] }, "Data": { "type": "array", "items": { "type": "object", "additionalProperties": false, "properties": { "FundCode": { "type": "string", "description": "场内基金的 6 位代码，保留前导零。" }, "FundName": { "type": "string", "description": "场内基金简称。" }, "FundType": { "type": "string", "description": "场内基金类型。" }, "DateKey": { "type": "string", "description": "本条排行对应的净值日期。", "format": "date" }, "UnitNetValue": { "type": "number", "description": "单位净值。" }, "AccumulatedNetValue": { "type": "number", "description": "累计净值。" }, "Week": { "type": "number", "description": "近 1 周收益率，单位为百分比。" }, "Month": { "type": "number", "description": "近 1 月收益率，单位为百分比。" }, "ThreeMonth": { "type": "number", "description": "近 3 月收益率，单位为百分比。" }, "SixMonth": { "type": "number", "description": "近 6 月收益率，单位为百分比。" }, "Year": { "type": "number", "description": "近 1 年收益率，单位为百分比。" }, "TwoYear": { "type": "number", "description": "近 2 年收益率，单位为百分比。" }, "ThreeYear": { "type": "number", "description": "近 3 年收益率，单位为百分比。" }, "YearToDate": { "type": "number", "description": "今年以来收益率，单位为百分比。" }, "SinceInception": { "type": "number", "description": "成立以来收益率，单位为百分比。" }, "EstablishingDate": { "type": "string", "description": "基金成立日期。", "format": "date" } }, "required": [ "FundCode", "FundName", "FundType", "DateKey", "UnitNetValue", "AccumulatedNetValue", "Week", "Month", "ThreeMonth", "SixMonth", "Year", "TwoYear", "ThreeYear", "YearToDate", "SinceInception", "EstablishingDate" ] }, "description": "按数据源排行顺序返回的场内基金列表。" } }, "description": "咕咕数据标准响应结构。", "additionalProperties": false, "required": [ "DataStatus", "Data" ] } } } }, "400": { "description": "参数错误，业务码 501。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "APPKEY 缺失或无效，业务码 504。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "订单到期或额度不足，业务码 503 或 505。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限，业务码 502。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误，业务码 900。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "基金排行数据暂不可用，业务码 901。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/fund-etf-open-ranking-list/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "type", "in": "query", "required": false, "description": "可选。按 FundType 精确筛选，不区分英文字母大小写；留空时不限制基金类型", "schema": { "type": "string", "maxLength": 32 } }, { "name": "keyword", "in": "query", "required": false, "description": "可选。按基金代码或基金名称进行不区分大小写的模糊筛选", "schema": { "type": "string", "maxLength": 64 } }, { "name": "pageIndex", "in": "query", "required": false, "description": "可选。分页页码，从 1 开始；仅传 pageSize 时默认使用第 1 页", "schema": { "type": "integer", "format": "int32", "minimum": 1 }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "可选。每页数量，取值范围 1~500；未传 pageIndex 和 pageSize 时返回全部匹配记录", "schema": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 500 }, "example": 100 } ], "x-apifox-folder": "商业\\/分析", "security": [ { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ] } }, "/fund/fund-open-ranking-list": { "get": { "summary": "开放式基金业绩排行", "description": "按基金类型查看多周期收益排行\n接口标签：开放式基金、业绩排行、类型筛选、基金排行、区间收益\n接口特性：\n- 按基金大类筛选当前可用的开放式基金最新日度业绩排行快照\n- 每条记录包含单位净值、累计净值、净值日期和当日净值增长率\n- 覆盖近 1 周、近 1 月、近 3 月、近 6 月和近 1 年收益率\n- 同时提供近 2 年、近 3 年、今年以来和成立以来收益率\n- type 支持全部、股票型、混合型、债券型、指数型、QDII 和 FOF\n- type 不区分 QDII、FOF 的英文字母大小写，其他中文类型应传完整名称\n- 正式接口返回当前类型的全部可用排行记录，无分页参数\n- 排行依据为基金净值区间收益，不是盘中估算值或场内成交价格涨跌\n详情页：https://www.gugudata.com/api/details/fundopenrankinglist", "operationId": "get_fundopenrankinglist", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenrankinglist" }, "x-gugudata-api-identity": "fundopenrankinglist", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "开放式基金的 6 位代码，保留前导零" }, "FundName": { "type": "string", "description": "开放式基金简称，用于排行列表展示" }, "DateKey": { "type": "string", "description": "本条业绩排行快照对应的净值日期，通常格式为 yyyy-MM-dd" }, "UnitNetValue": { "type": "number", "description": "基金在 DateKey 最近公布的单位净值" }, "AccumulatedNetValue": { "type": "number", "description": "基金在 DateKey 最近公布的累计净值" }, "DailyGrowthRate": { "type": "number", "description": "单位净值相对上一净值日的增长率，单位为百分比" }, "Week": { "type": "number", "description": "截至排行快照日的近 1 周收益率，单位为百分比" }, "Month": { "type": "number", "description": "截至排行快照日的近 1 月收益率，单位为百分比" }, "ThreeMonth": { "type": "number", "description": "截至排行快照日的近 3 月收益率，单位为百分比" }, "SixMonth": { "type": "number", "description": "截至排行快照日的近 6 月收益率，单位为百分比" }, "Year": { "type": "number", "description": "截至排行快照日的近 1 年收益率，单位为百分比" }, "TwoYear": { "type": "number", "description": "截至排行快照日的近 2 年收益率，单位为百分比" }, "ThreeYear": { "type": "number", "description": "截至排行快照日的近 3 年收益率，单位为百分比" }, "YearToDate": { "type": "number", "description": "从本年度首个净值日至排行快照日的收益率，单位为百分比" }, "SinceInception": { "type": "number", "description": "从基金成立日至排行快照日的累计收益率，单位为百分比" }, "Custom": { "type": "number", "description": "数据源提供的自定义统计区间收益率，单位为百分比" }, "Fee": { "type": "string", "description": "数据源公布的手续费或费率说明，可能包含百分号或文字" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/fund-open-ranking-list/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "type", "in": "query", "required": true, "description": "必填。基金大类，仅支持：全部、股票型、混合型、债券型、指数型、QDII、FOF；不在支持范围时返回参数错误", "schema": { "type": "string" }, "example": "指数型" } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/fund-value-estimation": { "get": { "summary": "开放式基金盘中净值估算", "description": "盘中估算净值、涨跌率与估算偏差\n接口标签：开放式基金、盘中估值、估算偏差、净值估算、盘中数据\n接口特性：\n- 返回盘中估算净值和估算涨跌率，用于交易时段内观察开放式基金参考走势\n- 同时返回最近公布的官方单位净值、官方日增长率和前一净值日单位净值\n- EstimatedDeviation 表示估算值与最近官方净值之间的偏差，便于比较估算结果\n- symbol 可传一个代码，也可使用英文逗号分隔最多 50 个 6 位基金代码\n- 传入 symbol 时优先按基金代码筛选；未传 symbol 时可使用 type 按基金类型筛选\n- type 和 symbol 均可省略，type 空值会按“全部”处理并返回当前可用结果\n- 非交易时段、基金未被覆盖或数据尚未更新时，可能返回空列表及明确状态说明\n- 估算结果仅供盘中参考，不等同于基金公司最终公布净值，也不代表可成交价格\n详情页：https://www.gugudata.com/api/details/fundvalueestimation", "operationId": "get_fundvalueestimation", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundvalueestimation" }, "x-gugudata-api-identity": "fundvalueestimation", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "当前估算记录所属基金的 6 位代码，保留前导零" }, "FundName": { "type": "string", "description": "基金名称，用于确认代码对应的开放式基金产品" }, "FundType": { "type": "string", "description": "基金所属类型，可用于结果分组和筛选" }, "EstimatedValue": { "type": "number", "description": "当前快照对应的盘中估算净值，通常保留至 4 位小数" }, "EstimatedGrowthRate": { "type": "number", "description": "盘中估算净值相对当日估算比较基准的涨跌率，单位为百分比；分红除息等净值调整时，该基准可能与前一日官方单位净值不同" }, "EstimatedGrowthReferenceValue": { "type": "number", "description": "根据当前估算值及估算涨跌率反算的参考净值；分红除息日可能与 NetAssetValueYesterday 不同" }, "NetAssetValue": { "type": "number", "description": "基金公司最近一次公布的官方单位净值，用作估算结果对照" }, "DailyGrowthRate": { "type": "number", "description": "最近官方单位净值对应的日增长率，单位为百分比" }, "EstimatedDeviation": { "type": "number", "description": "盘中估算净值与最近官方单位净值之间的数据源偏差值" }, "NetAssetValueYesterday": { "type": "number", "description": "前一个已公布净值日的官方单位净值" }, "SnapshotTime": { "type": "string", "description": "当前估算记录的更新时间，通常格式为 yyyy-MM-dd HH:mm；数据源未提供时可能为空" }, "IsEstimated": { "type": "boolean", "description": "是否为盘中估算结果；false 表示当前返回的是最近公布的官方净值参考" }, "EstimateStatus": { "type": "string", "description": "估算可用状态；AVAILABLE 表示估算可用，UNAVAILABLE 表示当前没有满足质量要求的盘中估算" }, "EstimateMethod": { "type": "string", "description": "估算来源与方法；UPSTREAM_REALTIME 表示实时数据源估算，INTERNAL_HOLDINGS_V1 表示基于最新披露持仓和实时行情计算，LATEST_OFFICIAL_NAV 表示最近官方净值参考" }, "ReferenceNAVDate": { "type": "string", "description": "本次估算使用的官方参考净值日期，格式为 yyyy-MM-dd" }, "EstimateConfidence": { "type": "number", "description": "内部持仓模型的估算置信度，范围为 0 至 1；其他估算方式可能返回 0" }, "HoldingCoverage": { "type": "number", "description": "内部持仓模型已获得实时行情的披露持仓占基金净值比例，单位为百分比；其他估算方式可能返回 0" }, "ModelVersion": { "type": "string", "description": "内部估值模型版本；非内部模型结果可能为空" }, "DataScope": { "type": "string", "description": "当前估算结果适用的基金覆盖范围说明" }, "NoDataReason": { "type": "string", "description": "有估算值时为空；基金存在但当前未提供估算值时返回具体原因，此时数值型估算字段的 0 不代表真实估算结果" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/fund-value-estimation/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "type", "in": "query", "required": false, "description": "可选。基金类型筛选值，默认“全部”；空字符串同样按“全部”处理。传入 symbol 后优先按基金代码筛选", "schema": { "type": "string" }, "example": "全部" }, { "name": "symbol", "in": "query", "required": false, "description": "可选。传单个 6 位开放式基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码会去重并保留前导零", "schema": { "type": "string" } } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/fundsymbols": { "get": { "summary": "公募基金代码枚举（分页）", "description": "仅用于准备基金代码参数，不返回净值或价格。\n仅返回当前有效代码，历史代码仍可用于已支持的历史数据查询。\n接口标签：开放式基金、最新净值、批量查询、基金净值、最新日数据\n详情页：https://www.gugudata.com/api/details/fundopenrealtime", "operationId": "get_get_fund_fundsymbols", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenrealtime" }, "x-gugudata-api-identity": "fundopenrealtime", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "pre", "x-gugudata-parent-api-identity": "fundopenrealtime", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/fundopenrealtime", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "pageindex", "in": "query", "required": false, "description": "用于分页获取基金代码、名称、类型和拼音信息。", "schema": { "type": "string" }, "example": "页码，从 1 开始" }, { "name": "pagesize", "in": "query", "required": false, "description": "用于分页获取基金代码、名称、类型和拼音信息。", "schema": { "type": "string" }, "example": "每页数量，取值范围 1~20" } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/historyminute": { "get": { "summary": "场内基金分时行情", "description": "场内基金多周期分时行情\n接口标签：场内基金、分钟行情、成交量、ETF、分时行情\n接口特性：\n- 按基金代码查询指定交易区间的场内基金分时行情；\n- 支持 1、5、15、30、60 分钟周期，满足分时图与 K 线图展示；\n- 返回开盘、收盘、最高、最低及周期末价格；\n- 同步提供成交量与成交额，便于观察活跃度和量价变化；\n- 支持 sh、sz 市场前缀，统一返回标准六位基金代码；\n- 5 至 60 分钟周期支持不复权、前复权和后复权；\n- 查询时间精确到秒，结果按时间顺序返回并提供总条数；\n- 适合行情看板、ETF 研究、盘中回溯与量化分析，不构成投资建议。\n详情页：https://www.gugudata.com/api/details/fundhistoryminute", "operationId": "get_fundhistoryminute", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundhistoryminute" }, "x-gugudata-api-identity": "fundhistoryminute", "security": [ { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ], "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "501", "title": "参数错误", "remark": "" }, { "code": "502", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "503", "title": "订单到期", "remark": "请检查接口订单状态。" }, { "code": "504", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "505", "title": "接口额度耗尽", "remark": "请检查剩余调用额度。" }, { "code": "900", "title": "接口内部错误", "remark": "请稍后重试。" }, { "code": "901", "title": "行情服务暂不可用", "remark": "请稍后重试；持续失败时请联系技术支持。" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "description": "接口业务状态信息。" }, "Data": { "type": "array", "description": "按周期结束时间升序排列的场内基金分时行情；合法无行情区间返回空数组。", "items": { "type": "object", "additionalProperties": false, "required": [ "DateTime", "Symbol", "Open", "Close", "High", "Low", "TradingVolume", "TradingAmount", "Latest" ], "properties": { "DateTime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$", "description": "当前分钟周期的结束时间，格式为 yyyy-MM-dd HH:mm:ss" }, "Symbol": { "type": "string", "pattern": "^\\d{6}$", "description": "当前行情记录所属场内基金的标准 6 位代码" }, "Open": { "type": "number", "description": "当前分钟周期的开盘价" }, "Close": { "type": "number", "description": "当前分钟周期的收盘价" }, "High": { "type": "number", "description": "当前分钟周期的最高价" }, "Low": { "type": "number", "description": "当前分钟周期的最低价" }, "TradingVolume": { "type": "integer", "format": "int64", "minimum": 0, "description": "当前分钟周期的成交量" }, "TradingAmount": { "type": "number", "minimum": 0, "description": "当前分钟周期的成交金额" }, "Latest": { "type": "number", "description": "当前分钟周期结束时的价格，与 Close 保持一致" } } } } }, "additionalProperties": false, "required": [ "DataStatus", "Data" ], "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "行情服务暂不可用，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/historyminute/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "可选鉴权位置。也可使用 AppKey、X-GUGUDATA-APPKEY、X-API-Key 请求头或 Bearer Token；至少提供一种。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": true, "description": "必填。单个 6 位场内基金代码；也兼容 sh513500 或 sz159915，服务端会去除市场前缀并按标准 6 位代码查询", "schema": { "type": "string", "pattern": "^(?:[sS][hH]|[sS][zZ])?\\d{6}$", "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols", "example": "513500" }, { "name": "beginDate", "in": "query", "required": true, "description": "必填。查询开始时间，严格使用 yyyyMMdd HH:mm:ss 格式，例如 20260701 09:30:00", "schema": { "type": "string", "pattern": "^\\d{8} \\d{2}:\\d{2}:\\d{2}$" }, "example": "20260701 09:30:00" }, { "name": "endDate", "in": "query", "required": true, "description": "必填。查询结束时间，格式与 beginDate 相同；不得早于开始时间，二者间隔最大为 366 个自然日", "schema": { "type": "string", "pattern": "^\\d{8} \\d{2}:\\d{2}:\\d{2}$" }, "example": "20260710 15:00:00" }, { "name": "period", "in": "query", "required": false, "description": "可选。分钟周期，仅支持 1、5、15、30、60；未传时默认 5", "schema": { "type": "integer", "format": "int32", "enum": [ 1, 5, 15, 30, 60 ], "default": 5 }, "example": 5 }, { "name": "adjust", "in": "query", "required": false, "description": "可选。复权方式：空值表示不复权，pre 表示前复权，after 表示后复权；1 分钟周期仅支持空值", "schema": { "type": "string", "enum": [ "", "pre", "after" ] } } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open-nav-history": { "get": { "summary": "开放式基金区间净值", "description": "指定区间的净值、收益、排名与基金事件\n接口标签：开放式基金、日期区间、多指标、历史净值\n接口特性：\n- 每次按一个基金代码、一种指标和明确日期区间查询，便于控制响应体大小\n- 支持单位净值、累计净值和累计收益率走势，可用于构建指定区间的基金图表\n- 支持同类排名及排名百分比，用于观察基金在同类产品中的相对位置变化\n- 支持分红送配和基金拆分记录，用于查询指定区间内的基金权益事件\n- beginDate 和 endDate 使用 yyyyMMdd 格式，二者间隔最大为 366 个自然日\n- 每次只支持一个标准 6 位基金代码，不接受批量代码或市场前缀\n- indicator 使用中文指标名称，返回结果中只有该指标对应的业务字段具有实际含义\n- 需要一次获取完整历史或最多 20 个基金时，应使用公募基金历史数据接口\n详情页：https://www.gugudata.com/api/details/fundopennavhistory", "operationId": "get_fundopennavhistory", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopennavhistory" }, "x-gugudata-api-identity": "fundopennavhistory", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Symbol": { "type": "string", "description": "当前历史记录所属开放式基金的 6 位代码，保留前导零" }, "DateKey": { "type": "string", "description": "走势和排名记录日期使用 yyyyMMdd；分红或拆分记录使用事件所属年份，具体取决于 indicator" }, "UnitNetWorth": { "type": "number", "description": "对应 DateKey 的单位净值；仅 indicator=单位净值走势时具有实际含义" }, "DailyGrowthRate": { "type": "number", "description": "对应 DateKey 的单位净值日增长率，单位为百分比；仅单位净值走势使用" }, "CumulativeNetWorth": { "type": "number", "description": "对应 DateKey 的累计净值；仅 indicator=累计净值走势时使用" }, "CumulativeYieldRate": { "type": "number", "description": "对应 DateKey 的累计收益率，单位为百分比；仅累计收益率走势使用" }, "SameTypeRanking": { "type": "string", "description": "同类排名走势时表示排名名次；同类排名百分比时表示排名百分位" }, "TotalRanking": { "type": "string", "description": "当前日期参与同类排名的基金总数；仅同类排名走势使用" }, "EquityRegistrationDate": { "type": "string", "description": "本次基金分红的权益登记日期；仅分红送配详情使用" }, "ExDividendDate": { "type": "string", "description": "本次基金分红的除息日期；仅分红送配详情使用" }, "DividendPerShare": { "type": "string", "description": "本次分红每份基金份额对应的金额说明；仅分红送配详情使用" }, "DividendPaymentDate": { "type": "string", "description": "本次基金分红的实际发放日期；仅分红送配详情使用" }, "SplitConversionDate": { "type": "string", "description": "基金份额拆分或折算的生效日期；仅拆分详情使用" }, "SplitType": { "type": "string", "description": "基金份额拆分、合并或折算的事件类型；仅拆分详情使用" }, "SplitConversionRatio": { "type": "string", "description": "基金份额拆分或折算比例说明；仅拆分详情使用" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open-nav-history/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": true, "description": "必填。单个 6 位开放式基金代码，保留前导零；不支持市场前缀或多个代码", "schema": { "type": "string" }, "example": 710001 }, { "name": "indicator", "in": "query", "required": true, "description": "必填。仅支持：单位净值走势、累计净值走势、累计收益率走势、同类排名走势、同类排名百分比、分红送配详情、拆分详情；必须传完整中文名称", "schema": { "type": "string" }, "example": "单位净值走势" }, { "name": "beginDate", "in": "query", "required": true, "description": "必填。查询开始日期，严格使用 yyyyMMdd 格式，例如 20260701", "schema": { "type": "string" }, "example": 20260701 }, { "name": "endDate", "in": "query", "required": true, "description": "必填。查询结束日期，严格使用 yyyyMMdd 格式；不得早于 beginDate，二者间隔最大为 366 个自然日", "schema": { "type": "string" }, "example": 20260710 } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open-nav-realtime": { "get": { "summary": "开放式基金最新净值", "description": "单只或全量开放式基金日净值快照\n接口标签：开放式基金、最新净值、单基金查询、基金净值、最新日数据\n接口特性：\n- 按单个基金代码返回最近一次公布的完整日净值快照，适合基金详情页使用\n- 同时返回单位净值、累计净值、上一净值日数据、日增长值和日增长率\n- 包含申购状态、赎回状态和手续费说明，可用于展示基金当前交易可用性\n- symbol 留空时返回当前可用的全量开放式基金快照，不提供分页能力\n- symbol 仅支持一个标准 6 位基金代码，不接受逗号分隔的批量代码\n- 与公募基金实时净值接口相比，本接口适合单基金或全量获取，前者支持分页和最多 50 个代码批量查询\n- 数据日期取基金公司最近一次公布净值的日期，非交易日不一定等于请求当天\n- 本接口不返回盘中估算值；需要盘中参考时应使用开放式基金净值估算接口\n详情页：https://www.gugudata.com/api/details/fundopennavrealtime", "operationId": "get_fundopennavrealtime", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopennavrealtime" }, "x-gugudata-api-identity": "fundopennavrealtime", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Symbol": { "type": "string", "description": "基金的 6 位代码，保留前导零，可用于其他开放式基金接口的 symbol 参数" }, "FundName": { "type": "string", "description": "基金简称，用于基金详情、列表和搜索结果展示" }, "DateKey": { "type": "string", "description": "最近一次公布单位净值的日期，格式为 yyyy-MM-dd" }, "UnitNetWorth": { "type": "number", "description": "基金公司在 DateKey 公布的单位净值，不是盘中估算值" }, "AccumulatedNetWorth": { "type": "number", "description": "基金公司在 DateKey 公布的累计净值，包含历史分红等累计影响" }, "PreviousUnitNetWorth": { "type": "number", "description": "DateKey 前一个已公布净值日的单位净值" }, "PreviousAccumulatedNetWorth": { "type": "number", "description": "DateKey 前一个已公布净值日的累计净值" }, "DailyGrowthValue": { "type": "number", "description": "当前单位净值相对上一净值日的增长值，可为负数或零" }, "DailyGrowthRate": { "type": "number", "description": "当前单位净值相对上一净值日的增长率，单位为百分比" }, "PurchaseStatus": { "type": "string", "description": "基金当前申购状态，例如开放申购、暂停申购或限制大额申购" }, "RedemptionStatus": { "type": "string", "description": "基金当前赎回状态，例如开放赎回或暂停赎回" }, "Fee": { "type": "string", "description": "数据源公布的申购手续费或费率说明，可能包含百分号或文字说明" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open-nav-realtime/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": false, "description": "可选。单个 6 位开放式基金代码，保留前导零；不支持市场前缀或多个代码。留空时返回当前可用的全量最新日净值快照", "schema": { "type": "string" }, "example": 17437 } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open/etfhistory": { "get": { "summary": "场内基金历史净值", "description": "指定日期区间的场内基金日净值\n接口标签：场内基金、日度历史、申赎状态、ETF、历史净值\n接口特性：\n- 按一个场内基金代码查询指定开始日期和结束日期内的日度净值记录\n- 每条记录包含单位净值、累计净值和日增长率，可用于绘制日度净值曲线\n- 同时返回对应净值日的申购状态和赎回状态，便于识别暂停申购或赎回情况\n- startDate 和 endDate 均使用 yyyyMMdd 格式，并按自然日期进行严格校验\n- 开始日期可以等于结束日期，但不能晚于结束日期；本接口不限制为交易日\n- 每次只接受一个 6 位场内基金代码，不支持逗号分隔的批量代码\n- 无匹配记录时 Data 为空且 DataTotalCount 为 0，不应将其解释为接口结构变化\n- 本接口返回日度净值，不提供分钟价格与成交量；分钟行情请使用场内基金分时接口\n详情页：https://www.gugudata.com/api/details/fundopenetfhistory", "operationId": "get_fundopenetfhistory", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenetfhistory" }, "x-gugudata-api-identity": "fundopenetfhistory", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "当前历史记录所属场内基金的 6 位代码，保留前导零" }, "NAVDate": { "type": "string", "description": "当前净值记录日期，格式为 yyyyMMdd" }, "NAV": { "type": "number", "description": "对应 NAVDate 的单位净值，不等同于场内成交价格" }, "CumulativeNetworth": { "type": "number", "description": "对应 NAVDate 的累计净值，包含历史分红等累计影响" }, "DailyGrowthRate": { "type": "number", "description": "对应 NAVDate 的单位净值日增长率，单位为百分比" }, "SubscriptionStatus": { "type": "string", "description": "对应 NAVDate 的基金申购状态，例如开放申购或暂停申购" }, "RedemptionStatus": { "type": "string", "description": "对应 NAVDate 的基金赎回状态，例如开放赎回或暂停赎回" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open/etfhistory/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": true, "description": "必填。单个 6 位场内基金代码，保留前导零；不支持市场前缀或多个代码", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols", "example": 511010 }, { "name": "startDate", "in": "query", "required": true, "description": "必填。查询开始日期，严格使用 yyyyMMdd 格式，例如 20260701", "schema": { "type": "string" }, "example": 20260701 }, { "name": "endDate", "in": "query", "required": true, "description": "必填。查询结束日期，严格使用 yyyyMMdd 格式；可以与 startDate 相同，但不得早于 startDate", "schema": { "type": "string" }, "example": 20260710 } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open/etfrealtime": { "get": { "summary": "场内基金实时净值", "description": "最新场内基金净值、市价与折溢价\n接口标签：场内基金、ETF、净值与市价、最新日数据\n接口特性：\n- 返回场内基金最近一次公布的单位净值和累计净值，适合展示最新日度净值快照\n- 同时提供上一净值日的单位净值、累计净值、增长值和增长率，便于比较净值变化\n- 返回对应数据日期的场内市场价格以及折溢价率，可用于比较交易价格与基金净值\n- symbol 留空时返回当前可用的全部场内基金，不使用分页参数\n- symbol 可传一个代码，也可使用英文逗号分隔最多 50 个 6 位基金代码\n- 批量代码会去除首尾空格和重复项，格式不正确或数量超限时返回参数错误\n- 净值以基金公司最近公布结果为准，市场价格也不代表逐笔或分钟级实时成交\n- 需要分钟价格、成交量和成交额时，应使用场内基金分时行情接口\n详情页：https://www.gugudata.com/api/details/fundopenetfrealtime", "operationId": "get_fundopenetfrealtime", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenetfrealtime" }, "x-gugudata-api-identity": "fundopenetfrealtime", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "场内交易基金的 6 位代码，保留前导零" }, "FundABBR": { "type": "string", "description": "场内交易基金简称，用于行情列表和基金检索展示" }, "FundType": { "type": "string", "description": "基金所属类型，用于区分 ETF、LOF 等场内基金类别" }, "UnitNetworth": { "type": "number", "description": "基金公司最近一次公布的单位净值，不等同于交易所实时成交价" }, "CumulativeNetworth": { "type": "number", "description": "基金公司最近一次公布的累计净值，体现历史累计价值" }, "PreDayUnitNetworth": { "type": "number", "description": "前一个已公布净值日的单位净值" }, "PreDayCumulativeNetworth": { "type": "number", "description": "前一个已公布净值日的累计净值" }, "Growth": { "type": "number", "description": "最新单位净值相对上一净值日的增长值，可为负数或零" }, "GrowthRate": { "type": "string", "description": "最新单位净值相对上一净值日的增长率，通常以带百分号文本返回" }, "MarketPrice": { "type": "string", "description": "对应数据日期的场内市场价格；需要分钟走势时应使用分时行情接口" }, "RateofDiscount": { "type": "string", "description": "场内市场价格相对单位净值的折价或溢价比例，通常包含百分号" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open/etfrealtime/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": false, "description": "可选。传单个 6 位场内基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码保留前导零。留空时返回当前可用的全部场内基金", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open/history": { "get": { "summary": "公募基金历史数据", "description": "完整历史净值、收益、排名与基金事件\n接口标签：开放式基金、全历史、多指标、历史净值、基金事件\n接口特性：\n- 一次获取基金可用的完整历史序列，不要求传入开始日期和结束日期\n- 支持单位净值、累计净值和累计收益率三类历史走势，适合绘制长期净值曲线\n- 支持同类排名及同类排名百分比，可用于观察基金在同类产品中的相对位置\n- 支持分红送配和基金拆分记录，可用于还原影响累计净值的历史基金事件\n- 支持货币基金每万份收益、7 日年化收益率以及申购赎回状态历史\n- 普通基金最多可批量查询 20 个代码，货币基金历史每次查询一个代码\n- type 决定 Data 中实际出现的业务字段，接入时应按所选指标读取对应字段\n- 需要限制查询日期或控制响应体大小时，建议改用开放式基金区间净值接口\n详情页：https://www.gugudata.com/api/details/fundopenhistory", "operationId": "get_fundopenhistory", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenhistory" }, "x-gugudata-api-identity": "fundopenhistory", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "当前历史记录所属基金的 6 位代码，保留前导零" }, "FundShort": { "type": "string", "description": "当前历史记录所属基金的简称" }, "FundType": { "type": "string", "description": "基金所属类型；用于批量查询时区分不同基金类别" }, "DateKey": { "type": "integer", "format": "int32", "description": "净值、收益、排名或货币基金记录日期，格式为 yyyyMMdd；仅相关 type 返回" }, "NetAssetValue": { "type": "number", "description": "对应 DateKey 的单位净值；仅 NAVTREND 模式返回" }, "DayGrowthRate": { "type": "number", "description": "对应 DateKey 的单位净值日增长率，单位为百分比；仅 NAVTREND 返回" }, "AccumulatedNetWorth": { "type": "number", "description": "对应 DateKey 的累计净值；仅 ACCUMULATEDNETWORTHTREND 返回" }, "AccumulatedRateofReturn": { "type": "number", "description": "对应 DateKey 的累计收益率，单位为百分比；仅 ACCUMULATEDRATEOFRETURN 返回" }, "SimilarRanking": { "type": "integer", "format": "int32", "description": "该基金在同类基金中的近 3 月收益排名；仅 SIMILARRANKINGS 返回" }, "TotalRanking": { "type": "integer", "format": "int32", "description": "当前日期参与同类排名的基金总数；仅 SIMILARRANKINGS 返回" }, "SimilarRankingPercent": { "type": "number", "description": "该基金同类近 3 月收益排名所处百分位；仅 SIMILARRANKINGSPERCENT 返回" }, "Year": { "type": "string", "description": "分红或拆分事件所属年份；仅 DIVIDENDDETAILS、SPLITDETAILS 返回" }, "RightsRegistrationDay": { "type": "string", "description": "分红权益登记日期；仅 DIVIDENDDETAILS 返回" }, "ExDividendDate": { "type": "string", "description": "基金本次分红的除息日期；仅 DIVIDENDDETAILS 返回" }, "PerShare": { "type": "string", "description": "本次分红每份基金份额对应的分红金额说明；仅 DIVIDENDDETAILS 返回" }, "ShareDividendDate": { "type": "string", "description": "本次基金分红的实际发放日期；仅 DIVIDENDDETAILS 返回" }, "SplitDate": { "type": "string", "description": "基金份额拆分或折算生效日期；仅 SPLITDETAILS 返回" }, "SplitType": { "type": "string", "description": "基金份额拆分、合并或折算的事件类型；仅 SPLITDETAILS 返回" }, "SplitRatio": { "type": "string", "description": "基金份额拆分或折算比例说明；仅 SPLITDETAILS 返回" }, "PerTenThousandIncome": { "type": "string", "description": "货币基金对应日期的每万份收益；仅 MONETARY 返回" }, "SevenDayAnnualizedIncome": { "type": "number", "description": "货币基金对应日期的 7 日年化收益率，单位为百分比；仅 MONETARY 返回" }, "PurchaseStatus": { "type": "string", "description": "货币基金对应日期的申购开放状态；仅 MONETARY 返回" }, "RedemptionStatus": { "type": "string", "description": "货币基金对应日期的赎回开放状态；仅 MONETARY 返回" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open/history/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": true, "description": "基金代码。普通基金可传单个代码，或使用英文逗号分隔最多 20 个 6 位代码；MONETARY 货币基金模式每次仅支持一个代码", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols", "example": 7401 }, { "name": "type", "in": "query", "required": true, "description": "返回指标。NAVTREND 为单位净值走势；ACCUMULATEDNETWORTHTREND 为累计净值走势；ACCUMULATEDRATEOFRETURN 为累计收益率；SIMILARRANKINGS 为同类排名；SIMILARRANKINGSPERCENT 为排名百分比；DIVIDENDDETAILS 为分红；SPLITDETAILS 为拆分；MONETARY 为货币基金收益", "schema": { "type": "string" }, "example": "NAVTREND" } ], "x-apifox-folder": "商业\\/分析" } }, "/fund/open/realtime": { "get": { "summary": "公募基金实时净值", "description": "最新开放式基金日净值与申赎状态\n接口标签：开放式基金、最新净值、批量查询、基金净值、最新日数据\n接口特性：\n- 返回基金公司最近一次公布的单位净值和累计净值，适合展示每日净值快照\n- 同时返回上一净值日数据、日增长值和日增长率，便于比较前后两个净值日\n- 包含申购状态、赎回状态和手续费说明，可用于基金详情页和产品筛选\n- 不传 symbol 时使用 pageIndex 和 pageSize 分页，DataTotalCount 表示全部基金数量\n- 传入 symbol 时按代码筛选，可使用英文逗号一次查询最多 50 个基金代码\n- 批量代码会去除首尾空格和重复项，返回结果仍使用标准 6 位基金代码\n- 数据日期以基金公司最新公布结果为准，非交易日或未更新时不一定等于当天\n- 本接口不是盘中估值或场内成交行情，盘中参考应使用净值估算或分时行情接口\n详情页：https://www.gugudata.com/api/details/fundopenrealtime", "operationId": "get_fundopenrealtime", "tags": [ "商业/分析" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fundopenrealtime" }, "x-gugudata-api-identity": "fundopenrealtime", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "服务端识别并记录的本次业务查询参数摘要，不包含 APPKEY 等鉴权信息" }, "StatusCode": { "type": "integer", "format": "int32", "description": "业务状态码；100 表示正常返回，其他值需结合 StatusDescription 判断" }, "StatusDescription": { "type": "string", "description": "业务状态说明；成功时说明请求结果，失败时说明参数、权限或数据依赖问题" }, "ResponseDateTime": { "type": "string", "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "当前查询条件下的数据总量；分页接口通常表示全部匹配数量，而不是当前页条数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "FundCode": { "type": "string", "description": "基金的 6 位代码，保留前导零，可直接用于其他基金接口的 symbol 参数" }, "FundABBR": { "type": "string", "description": "基金简称，用于列表、搜索结果和净值卡片展示" }, "UnitNetworth": { "type": "number", "description": "基金公司最近一次公布的单位净值，不是盘中估算值或场内成交价" }, "CumulativeNetworth": { "type": "number", "description": "基金公司最近一次公布的累计净值，包含历史分红等累计影响" }, "PreDayUnitNetworth": { "type": "number", "description": "前一个已公布净值日的单位净值，用于计算本期净值变化" }, "PreDayCumulativeNetworth": { "type": "number", "description": "前一个已公布净值日的累计净值，用于比较累计净值变化" }, "DailyGrowth": { "type": "number", "description": "最新单位净值相对上一净值日的增长值，可为负数或零" }, "DailyGrowthRate": { "type": "number", "description": "最新单位净值相对上一净值日的增长率，单位为百分比" }, "SubscriptionStatus": { "type": "string", "description": "基金当前申购状态，例如开放申购、暂停申购或限制大额申购" }, "RedemptionStatus": { "type": "string", "description": "基金当前赎回状态，例如开放赎回或暂停赎回" }, "ServiceCharge": { "type": "string", "description": "数据源公布的申购手续费或费率说明，可能包含百分号或文字说明" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/fund/open/realtime/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": false, "description": "可选。传单个 6 位基金代码，或使用英文逗号分隔多个代码，最多 50 个；代码保留前导零。传入后按代码筛选，pageIndex 和 pageSize 不影响结果，但显式传入时仍须满足合法范围", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/fund/symbols" }, { "name": "pageIndex", "in": "query", "required": false, "description": "分页页码，从 1 开始；仅在 symbol 为空时影响结果。即使传入 symbol，显式提供的 pageIndex 也必须大于或等于 1", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "每页返回条数，当前取值范围为 1~50；仅在 symbol 为空时影响结果。即使传入 symbol，显式提供的 pageSize 也必须在合法范围内", "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "x-apifox-folder": "商业\\/分析" } }, "/imagerecognition/html2pdf": { "post": { "summary": "HTML/URL 转 PDF", "description": "网页转 PDF，支持公开或私有存储\n接口标签：网络工具、文件处理、PDF、高效生成 PDF、安全文件存储\n接口特性：\n- 超高性能转换效率\n- 支持将传递的 HTML 转换为 PDF，支持转换 HTML 中的 CSS 格式\n- 支持传递网站 URL，直接转换页面成对应的 PDF 文件\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“HTML/URL 转 PDF”提供标准化能力，便于快速接入现有业务\n- 适合将“HTML/URL 转 PDF”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n详情页：https://www.gugudata.com/api/details/html2pdf", "operationId": "post_html2pdf", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/html2pdf" }, "x-gugudata-api-identity": "html2pdf", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "公开存储时返回文件下载地址；私有存储时返回文件引用，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/html2pdf/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "可选参数为 HTML 或 URL（注意，当类型为 URL 时，需要保证页面可以正常请求，我们的接口不解决加密页面、反爬虫页面等不能正常返回 HTML 的页面请求）" }, "content": { "type": "string", "description": "内容正文，如果 type=HTML，那么传递 HTML 内容；如果 type=URL，那么传递需要存储为 PDF 的站点 URL 即可" }, "landscape": { "type": "integer", "format": "int32", "description": "控制生成 PDF 是否为横向页面模式，传递 1 控制页面横向渲染模式，默认为 0" }, "showpages": { "type": "integer", "format": "int32", "description": "控制生成的 PDF 是否在页脚包含页码信息，传递 1 控制页脚生成页码，默认为 0" }, "filename": { "type": "string", "description": "可选参数，控制生成的文件名称，不需要后缀" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "type", "content" ] }, "example": { "type": "YOUR_VALUE", "content": "YOUR_VALUE", "landscape": 0, "showpages": 0, "filename": "N/A", "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/html2word": { "post": { "summary": "HTML 转 Word", "description": "网页转 Word，支持公开或私有存储\n接口标签：网络工具、文件处理、高效转换为 Word、安全文件存储\n接口特性：\n- 超高性能转换效率\n- 支持将传递的 HTML 转换为 Word，支持 HTML 中的 CSS 格式在 Word 文档中的呈现\n- 支持传递网站的 URL，直接转换成对应的 Word 格式返回\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 已完美支持 Word 中各类样式、列表等格式的解析\n- 接口服务多节点部署\n- 围绕“HTML 转 Word”提供标准化能力，便于快速接入现有业务\n- 适合将“HTML 转 Word”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/html2word", "operationId": "post_html2word", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/html2word" }, "x-gugudata-api-identity": "html2word", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "公开存储时返回文件下载地址；私有存储时返回文件引用，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/html2word/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "type": { "type": "string", "description": "可选参数为 HTML 或 URL（注意，当类型为 URL 时，需要保证页面可以正常请求，我们的接口不解决加密页面、反爬虫页面等不能正常返回 HTML 的页面请求）" }, "content": { "type": "string", "description": "内容正文，如果 type=HTML，那么传递 HTML 内容；如果 type=URL，那么传递需要存储为 Word 的站点 URL 即可" }, "filename": { "type": "string", "description": "可选参数，控制生成的文件名称，不需要后缀" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "type", "content" ] }, "example": { "type": "YOUR_APPKEY", "content": "YOUR_VALUE", "filename": "N/A", "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/imagestreamocr": { "post": { "summary": "通用图片文件流 OCR 到文本", "description": "上传图片文件并返回按行整理的识别文字，支持 JPEG、PNG、GIF、BMP 与 TIFF，适合扫描件、截图、表单、票据、合同、课件和档案图片的文字录入。识别效果受图片清晰度、文字方向、遮挡和排版影响，关键内容建议人工复核。\n详情页：https://www.gugudata.com/api/details/imagestreamocr", "operationId": "post_imagestreamocr", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/imagestreamocr" }, "x-gugudata-api-identity": "imagestreamocr", "x-gugudata-business-status-codes": [ { "code": "100", "title": "请求成功", "remark": "HTTP 200。" }, { "code": "501", "title": "参数或图片错误", "remark": "HTTP 400。" }, { "code": "502", "title": "请求频率受限", "remark": "HTTP 429。" }, { "code": "503", "title": "订单已到期", "remark": "HTTP 403。" }, { "code": "504", "title": "APPKEY 错误", "remark": "HTTP 401。" }, { "code": "505", "title": "调用额度耗尽", "remark": "HTTP 403。" }, { "code": "900", "title": "内部错误", "remark": "HTTP 500。" }, { "code": "901", "title": "识别服务不可用", "remark": "HTTP 503。" } ], "responses": { "200": { "description": "图片文字识别成功。", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "DataStatus": { "type": "object", "description": "接口业务状态信息。", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ] }, "Data": { "type": "object", "additionalProperties": false, "properties": { "SourceImageUrl": { "type": "string", "description": "正式文件上传时为空，Demo 返回公开示例图片地址。" }, "ResultText": { "type": "array", "items": { "type": "string" }, "description": "按文本行返回的识别结果。" } }, "required": [ "SourceImageUrl", "ResultText" ] } }, "required": [ "DataStatus", "Data" ] } } } }, "400": { "description": "参数、图片格式、大小或尺寸不符合要求，业务码 501。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "APPKEY 缺失或无效，业务码 504。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "订单到期或调用额度耗尽，业务码 503 或 505。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限，业务码 502。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误，业务码 900。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "图片文字识别服务暂时不可用，业务码 901。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/imagestreamocr/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": false, "properties": { "appKey": { "type": "string", "description": "也可通过 multipart form 传递 APPKEY。" }, "imagefile": { "type": "string", "format": "binary", "description": "JPEG、PNG、GIF、BMP 或 TIFF 图片；最大 20 MiB，单边不超过 12000 像素且总像素不超过 4000 万。" } }, "required": [ "imagefile" ] }, "encoding": { "imagefile": { "contentType": "image/*" } } } } }, "x-apifox-folder": "图像\\/转换", "security": [ { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ] } }, "/imagerecognition/markdown2pdf": { "post": { "summary": "Markdown 转 PDF", "description": "Markdown 转 PDF 文件\n接口标签：文件处理、PDF、高效生成 PDF、安全文件存储\n接口特性：\n- 超高性能转换效率\n- 支持将传递的 Markdown 转换为 PDF\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“Markdown 转 PDF”提供标准化能力，便于快速接入现有业务\n- 适合将“Markdown 转 PDF”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/markdown2pdf", "operationId": "post_markdown2pdf", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/markdown2pdf" }, "x-gugudata-api-identity": "markdown2pdf", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "公开存储时返回文件下载地址；私有存储时返回文件引用，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/markdown2pdf/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "content": { "type": "string", "description": "Markdown 内容" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "content" ] }, "example": { "content": "YOUR_VALUE", "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/ocr": { "post": { "summary": "通用图片地址 OCR 到文本", "description": "通用图像识别接口\n接口标签：文件处理、OCR、基于机器学习、精准识别率\n接口特性：\n- 通用的识别接口， 支持多种图片格式\n- 支持中英文字符混合识别\n- 支持 Base64 以及网络地址传参\n- 基于机器学习不断提高的识别率\n- 围绕“通用图片地址 OCR 到文本”提供标准化能力，便于快速接入现有业务\n- 适合将“通用图片地址 OCR 到文本”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/ocr", "operationId": "post_ocr", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ocr" }, "x-gugudata-api-identity": "ocr", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "SourceImageUrl": { "type": "string", "description": "不含查询凭据的原始图片地址；Base64 输入返回 BASE64" }, "ResultText": { "type": "array", "items": { "type": "string" }, "description": "识别出的文本数组，识别后的每一行文字对应数组的每一个元素" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/ocr/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "imageurl": { "type": "string", "description": "图片 URL 地址，与图标 Base64 编码选其一进行传参" }, "imagebase64": { "type": "string", "description": "图片 Base64 编码，与图标 URL 地址选其一进行传参" } } }, "example": { "imageurl": "YOUR_VALUE", "imagebase64": "YOUR_VALUE" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/ocr2word": { "post": { "summary": "图片 OCR 转 Word", "description": "将图片中的文字和基础版式转换为可编辑的 Word 文档。支持 HTTPS 图片地址或 Base64 图片二选一传入，支持 JPEG、PNG、GIF、BMP、TIFF，单张图片最大 20 MB、最长边最大 12000 像素且总像素不超过 4000 万。可选指定识别语言、输出文件名以及公开或私有存储；合同、票据等敏感材料建议使用 private。识别效果受图片清晰度、字体、排版和语言影响，调用方应对关键内容进行复核。\n详情页：https://www.gugudata.com/api/details/ocr2word", "operationId": "post_ocr2word", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ocr2word" }, "x-gugudata-api-identity": "ocr2word", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "501", "title": "参数错误", "remark": "" }, { "code": "502", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "503", "title": "订单已过期", "remark": "请前往开发者中心确认订单有效期" }, { "code": "504", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "505", "title": "调用额度不足", "remark": "请前往开发者中心确认剩余调用额度" }, { "code": "900", "title": "服务内部错误", "remark": "请稍后重试" }, { "code": "901", "title": "OCR 服务暂时不可用", "remark": "请稍后重试" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "正式请求返回输入摘要；固定公开 Demo 展示完整示例输入。", "type": "string" } }, "description": "接口业务状态信息。", "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ] }, "Data": { "type": "object", "additionalProperties": false, "properties": { "SourceImageUrl": { "type": "string", "description": "不含查询凭据的原始图片 URL；Base64 输入返回 BASE64" }, "ResultWordFileUrl": { "type": [ "string", "null" ], "format": "uri", "description": "公开存储模式下的 Word 下载地址；私有存储模式下为空" }, "Storage": { "type": "string", "enum": [ "public", "private" ], "description": "文件存储模式" }, "FileId": { "type": [ "string", "null" ], "description": "私有存储模式下的文件标识，可用于申请短期下载地址" }, "FileName": { "type": "string", "description": "生成的 Word 文件名" }, "ContentType": { "type": "string", "description": "Word 文件 MIME 类型" }, "FileSize": { "type": "integer", "format": "int64", "minimum": 1, "description": "Word 文件大小，单位为字节" }, "Language": { "type": "string", "enum": [ "auto", "zh-cn", "zh-tw", "en", "ja", "ko", "fr", "de" ], "description": "本次请求使用的语言模式" }, "ProcessingTimeMs": { "type": "integer", "format": "int64", "minimum": 0, "description": "OCR 处理耗时，单位为毫秒" }, "RequestId": { "type": "string", "description": "本次处理的请求标识" }, "GeneratedAt": { "type": "string", "format": "date-time", "description": "Word 文件生成时间" } }, "required": [ "SourceImageUrl", "ResultWordFileUrl", "Storage", "FileId", "FileName", "ContentType", "FileSize", "Language", "ProcessingTimeMs", "RequestId", "GeneratedAt" ], "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。", "additionalProperties": false, "required": [ "DataStatus", "Data" ] } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "图片转 Word 服务暂时不可用，业务状态码为 901。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/ocr2word/demo" }, "security": [ { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ], "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "兼容历史客户端的 Query APPKEY；新接入推荐使用 X-GUGUDATA-APPKEY 请求头。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "oneOf": [ { "required": [ "imageurl" ], "not": { "required": [ "imagebase64" ] } }, { "required": [ "imagebase64" ], "not": { "required": [ "imageurl" ] } } ], "properties": { "appkey": { "type": "string", "minLength": 1, "description": "接口 APPKEY，可通过请求体传入，也可使用 Query、Header 或 Bearer" }, "imageurl": { "type": "string", "format": "uri", "maxLength": 2048, "pattern": "^https://", "description": "公开可访问的 HTTPS 图片地址，与 imagebase64 必须且只能提供一个" }, "imagebase64": { "type": "string", "format": "byte", "maxLength": 27962064, "description": "图片 Base64 编码或 image/* Base64 Data URI，与 imageurl 必须且只能提供一个" }, "language": { "type": "string", "enum": [ "auto", "zh-cn", "zh-tw", "en", "ja", "ko", "fr", "de" ], "default": "auto", "description": "可选的识别语言，auto 表示自动混合识别" }, "storage": { "type": "string", "enum": [ "public", "private" ], "default": "public", "description": "可选的文件存储模式；敏感材料建议使用 private" }, "fileName": { "type": "string", "maxLength": 80, "description": "可选的输出文件名，无论传入何种扩展名均生成 DOCX" } } }, "example": { "imageurl": "https://static.gugudata.com/ocr_demo_image_52.jpg", "language": "auto", "storage": "public", "fileName": "ocr-demo.docx" } }, "application/x-www-form-urlencoded": { "schema": { "type": "object", "additionalProperties": false, "oneOf": [ { "required": [ "imageurl" ], "not": { "required": [ "imagebase64" ] } }, { "required": [ "imagebase64" ], "not": { "required": [ "imageurl" ] } } ], "properties": { "appkey": { "type": "string", "minLength": 1, "description": "接口 APPKEY，可通过请求体传入，也可使用 Query、Header 或 Bearer" }, "imageurl": { "type": "string", "format": "uri", "maxLength": 2048, "pattern": "^https://", "description": "公开可访问的 HTTPS 图片地址，与 imagebase64 必须且只能提供一个" }, "imagebase64": { "type": "string", "format": "byte", "maxLength": 27962064, "description": "图片 Base64 编码或 image/* Base64 Data URI，与 imageurl 必须且只能提供一个" }, "language": { "type": "string", "enum": [ "auto", "zh-cn", "zh-tw", "en", "ja", "ko", "fr", "de" ], "default": "auto", "description": "可选的识别语言，auto 表示自动混合识别" }, "storage": { "type": "string", "enum": [ "public", "private" ], "default": "public", "description": "可选的文件存储模式；敏感材料建议使用 private" }, "fileName": { "type": "string", "maxLength": 80, "description": "可选的输出文件名，无论传入何种扩展名均生成 DOCX" } } }, "example": { "imageurl": "https://static.gugudata.com/ocr_demo_image_52.jpg", "language": "auto", "storage": "public", "fileName": "ocr-demo.docx" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/pdf-splitter": { "post": { "summary": "PDF 分割拆分", "description": "PDF 按页拆分与文件打包。\n- 上传 PDF，按指定页数拆分为多个文件；\n- 支持每份 1～100 页的连续分组；\n- 保持原文页面顺序与页面尺寸；\n- 支持文本型、扫描型及混合 PDF；\n- 单次支持不超过 50 MiB、500 页的文档；\n- 单次最多生成 100 个拆分 PDF；\n- 可逐个获取文件，或打包为 ZIP 下载；\n- 支持公开下载与私有文件交付；\n- 适合报告分发、合同整理与档案拆分；\n- 可用于教材、课件和大型资料分段共享。\nAPPKEY 支持 Query、multipart appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key Header 和 Bearer；同值可共存，冲突返回 501。未知和重复参数不接受。最多拆出 100 个 PDF，ZIP 模式同样适用。", "operationId": "post_pdfsplitter", "tags": [ "图像/转换" ], "externalDocs": { "url": "https://www.gugudata.com/api/details/pdfsplitter" }, "x-gugudata-api-identity": "pdfsplitter", "x-gugudata-business-status-codes": [ { "code": "100", "title": "成功", "remark": "HTTP 200" }, { "code": "501", "title": "参数或 PDF 文件无效", "remark": "HTTP 400" }, { "code": "502", "title": "请求频率受限", "remark": "HTTP 429" }, { "code": "503", "title": "订单到期", "remark": "HTTP 403" }, { "code": "504", "title": "APPKEY 缺失或无效", "remark": "HTTP 401" }, { "code": "505", "title": "额度耗尽", "remark": "HTTP 403" }, { "code": "900", "title": "内部错误", "remark": "HTTP 500" }, { "code": "901", "title": "拆分或文件交付暂不可用", "remark": "HTTP 503" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 100 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 1, "maximum": 100, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "oneOf": [ { "type": "object", "properties": { "uuid": { "type": "string", "format": "uuid" }, "num_files": { "type": "integer", "minimum": 1, "maximum": 100, "description": "实际交付文件数量；ZIP 为 1。" }, "files": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string", "format": "uri" } }, "pdf_files": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "string", "format": "uri" } } }, "required": [ "uuid", "num_files", "files", "pdf_files" ], "additionalProperties": false }, { "type": "object", "properties": { "uuid": { "type": "string", "format": "uuid" }, "num_files": { "type": "integer", "minimum": 1, "maximum": 100, "description": "实际交付文件数量；ZIP 为 1。" }, "files": { "type": "array", "minItems": 1, "maxItems": 100, "items": { "type": "object", "properties": { "storage": { "type": "string", "enum": [ "private" ] }, "file_id": { "type": "string" }, "file_name": { "type": "string" }, "content_type": { "type": "string", "enum": [ "application/pdf", "application/zip" ] }, "size_bytes": { "type": "integer", "minimum": 1 }, "index": { "type": "integer", "minimum": 0, "maximum": 99 } }, "required": [ "storage", "file_id", "file_name", "content_type", "size_bytes", "index" ], "additionalProperties": false } } }, "required": [ "uuid", "num_files", "files" ], "additionalProperties": false } ] } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "400": { "description": "参数或 PDF 文件无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 501 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "401": { "description": "APPKEY 缺失或无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 504 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "403": { "description": "订单到期 / 额度耗尽", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 503, 505 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "429": { "description": "请求频率受限", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 502 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "500": { "description": "内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 900 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "503": { "description": "拆分或文件交付暂不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 901 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "maximum": 0, "description": "与 num_files 相等，表示交付数量；ZIP 为 1，失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/pdf-splitter/demo" }, "parameters": [ { "name": "pageSize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } }, { "name": "isZip", "in": "query", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "storage", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "public", "private" ], "default": "public" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": false, "required": [ "file" ], "properties": { "file": { "type": "string", "format": "binary", "x-maxBytes": 52428800, "description": "未加密 PDF；最大 50 MiB、500 页。" }, "appkey": { "type": "string" }, "pageSize": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 }, "isZip": { "type": "boolean", "default": false }, "storage": { "type": "string", "enum": [ "public", "private" ], "default": "public" } } }, "encoding": { "file": { "contentType": "application/pdf" } } } } }, "x-apifox-folder": "图像\\/转换", "security": [ { "AppKeyQuery": [] }, { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] } ], "x-body-appkey-supported": true } }, "/imagerecognition/pdf2format": { "post": { "summary": "PDF 解析格式化输出", "description": "PDF 内容结构化解析\n接口标签：文件处理、PDF、多种格式输出、超精准识别率\n接口特性：\n- 通用的识别接口， 支持标准 PDF 文件解析\n- 多种格式输出，支持 TEXT HTML XML TAG\n- HTML 包含完美排版格式\n- 基于机器学习不断提高的识别率\n- 1M 文件毫秒级识别性能\n- 围绕“PDF 解析格式化输出”提供标准化能力，便于快速接入现有业务\n- 适合将“PDF 解析格式化输出”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n详情页：https://www.gugudata.com/api/details/pdf2format", "operationId": "post_pdf2format", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/pdf2format" }, "x-gugudata-api-identity": "pdf2format", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Data": { "type": "string", "description": "接口解析 PDF 返回数据，格式由 type 参数决定" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/pdf2format/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "type", "in": "query", "required": true, "description": "定义输出格式，可选 text|html|xml|tag", "schema": { "type": "string" }, "example": "YOUR_VALUE" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "pdffile": { "type": "string", "format": "binary", "description": "文件格式参数，待转换的 PDF 文件" } }, "required": [ "pdffile" ] }, "example": { "pdffile": "YOUR_VALUE" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/pdf2html": { "post": { "summary": "PDF 转 HTML", "description": "PDF 文本转换与 HTML 交付。\n- 上传文本型 PDF，转换为可浏览的 HTML；\n- 提取文档文字，便于网页展示与阅读；\n- 保留页面顺序及文字的基本位置；\n- 支持中文、英文及常见混排文字；\n- 单次支持不超过 20 MiB、100 页的 PDF；\n- 公开模式直接返回 HTML 文件地址；\n- 私有模式提供受控的文件访问方式；\n- 转换结果可用于复制、检索与内容整理；\n- 适合报告、说明书、课件与资料在线展示；\n- 复杂排版建议复核，扫描型 PDF 暂不支持。\nAPPKEY 支持 Query、AppKey/X-GUGUDATA-APPKEY/X-API-Key 请求头、Bearer 或 multipart appkey。多处相同值允许，冲突返回 501；缺失返回 504。storage 可在表单或 Query 传递，两者不得冲突。", "operationId": "post_pdf2html", "tags": [ "图像/转换" ], "externalDocs": { "url": "https://www.gugudata.com/api/details/pdf2html" }, "x-gugudata-api-identity": "pdf2html", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "转换成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "const": 100 }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 1 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "oneOf": [ { "type": "string", "format": "uri", "description": "public 模式的 HTML 文件地址" }, { "type": "object", "properties": { "storage": { "type": "string", "enum": [ "private" ] }, "file_id": { "type": "string" }, "file_name": { "type": "string" }, "content_type": { "type": "string" }, "size_bytes": { "type": "integer", "minimum": 1 }, "index": { "type": [ "integer", "null" ] } }, "required": [ "storage", "file_id", "file_name", "content_type", "size_bytes", "index" ], "additionalProperties": false } ], "description": "公开 HTML 地址或私有文件引用。" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false }, "example": { "DataStatus": { "RequestParameter": "input=file&format=pdf&bytes=64821&storage=public", "StatusCode": 100, "StatusDescription": "转换成功", "ResponseDateTime": "2026-09-05 12:00:00.000", "DataTotalCount": 1 }, "Data": "https://api.gugudata.com/assets/demos/pdf2html/v1/result.html" } } } }, "400": { "description": "参数或文件无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 501 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "401": { "description": "APPKEY 缺失或无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 504 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "403": { "description": "订单到期 / 额度耗尽", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 503, 505 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "429": { "description": "请求频率受限", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 502 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "500": { "description": "内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 900 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "503": { "description": "转换或文件交付暂不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅包含文件类型、大小与存储方式摘要；固定 Demo 展示公开示例输入。" }, "StatusCode": { "type": "integer", "enum": [ 901 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0 } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/pdf2html/demo" }, "parameters": [ { "name": "storage", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "public", "private" ] } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": false, "required": [ "file" ], "properties": { "appkey": { "type": "string", "description": "兼容 multipart 鉴权；也可通过请求头或 Query 传递。" }, "file": { "type": "string", "format": "binary", "description": "一个未加密、包含可提取文字的 PDF；最大 20 MiB、100 页。", "x-maxBytes": 20971520 }, "storage": { "type": "string", "enum": [ "public", "private" ], "default": "public" } } }, "encoding": { "file": { "contentType": "application/pdf" } } } } }, "x-apifox-folder": "图像\\/转换", "security": [ { "AppKeyQuery": [] }, { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] } ], "x-body-appkey-supported": true } }, "/imagerecognition/pdf2text": { "post": { "summary": "PDF 文字识别与文本提取", "description": "PDF 文字识别与纯文本提取。\n- 上传 PDF 文件即可识别并返回文字；\n- 支持文本型、扫描型及混合 PDF；\n- 支持中文、英文及常见混排内容；\n- 可处理多页文档，按页面顺序提取文字；\n- 单次支持不超过 20 MiB、20 页的 PDF；\n- 返回纯文本，便于复制、整理和保存；\n- 可衔接全文检索、知识库与内容分析；\n- 适合合同、报告、课件与档案数字化；\n- JSON 结果便于接入业务系统和文档流程；\n- 复杂排版和低清扫描件建议人工复核。\nAPPKEY 支持 Query、multipart appkey、AppKey/X-GUGUDATA-APPKEY/X-API-Key 请求头及 Bearer。同值允许，冲突返回 501；缺失返回 504。未知及重复参数不接受。", "operationId": "post_pdf2text", "tags": [ "图像/转换" ], "externalDocs": { "url": "https://www.gugudata.com/api/details/pdf2text" }, "x-gugudata-api-identity": "pdf2text", "x-gugudata-business-status-codes": [ { "code": "100", "title": "成功", "remark": "HTTP 200" }, { "code": "501", "title": "参数或 PDF 文件无效", "remark": "HTTP 400" }, { "code": "502", "title": "请求频率受限", "remark": "HTTP 429" }, { "code": "503", "title": "订单到期", "remark": "HTTP 403" }, { "code": "504", "title": "APPKEY 缺失或无效", "remark": "HTTP 401" }, { "code": "505", "title": "额度耗尽", "remark": "HTTP 403" }, { "code": "900", "title": "内部错误", "remark": "HTTP 500" }, { "code": "901", "title": "PDF 文字识别暂不可用", "remark": "HTTP 503" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 100 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 1, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "string", "description": "识别后的完整纯文本；无文字时为空字符串。" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "400": { "description": "参数或 PDF 文件无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 501 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "401": { "description": "APPKEY 缺失或无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 504 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "403": { "description": "订单到期 / 额度耗尽", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 503, 505 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "429": { "description": "请求频率受限", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 502 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "500": { "description": "内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 900 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "503": { "description": "PDF 文字识别暂不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回文件类型、大小、页数摘要；固定 Demo 展示完整公开输入。" }, "StatusCode": { "type": "integer", "enum": [ 901 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "const": 0, "description": "成功为 1，失败为 0，不表示文本行数或页数。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false, "description": "响应状态与结果数量。" }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/pdf2text/demo" }, "parameters": [], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "additionalProperties": false, "required": [ "pdffile" ], "properties": { "appkey": { "type": "string", "description": "APPKEY；也可使用 Query 或请求头。" }, "pdffile": { "type": "string", "format": "binary", "x-maxBytes": 20971520, "description": "单个未加密 PDF，最大 20 MiB、20 页；支持文本、扫描及混合内容。" } } }, "encoding": { "pdffile": { "contentType": "application/pdf" } } } } }, "x-apifox-folder": "图像\\/转换", "security": [ { "AppKeyQuery": [] }, { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] } ], "x-body-appkey-supported": true } }, "/imagerecognition/pdf2word": { "post": { "summary": "通用 PDF 文件流 OCR 到 Word", "description": "PDF 转 Word，支持公开或私有存储\n接口标签：文件处理、OCR、PDF、基于机器学习、超精准识别率\n接口特性：\n- 通用识别接口\n- 支持中英文等多语言字符混合识别\n- formdata 格式 PDF 文件流传参\n- 基于机器学习不断提高的识别率\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“通用 PDF 文件流 OCR 到 Word”提供标准化能力，便于快速接入现有业务\n- 适合将“通用 PDF 文件流 OCR 到 Word”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/pdf2word", "operationId": "post_pdf2word", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/pdf2word" }, "x-gugudata-api-identity": "pdf2word", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "公开存储时返回文件下载地址；私有存储时返回文件引用，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/pdf2word/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "pdffile": { "type": "string", "format": "binary", "description": "formdata 文件流" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "pdffile" ] }, "example": { "pdffile": "N/A", "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/ppt-to-images": { "post": { "summary": "PPT 转高精度图片", "description": "PPT 转图片，支持公开或私有存储\n接口标签：文件处理、图片处理、文件转换\n接口特性：\n- 支持将 PPT 文件转换为高质量图片序列\n- 支持导出图片的高清放大，最大为 4 倍高清导出\n- 支持 .ppt 和 .pptx 格式\n- 保持原始 PPT 的布局和样式\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“PPT 转高精度图片”提供标准化能力，便于快速接入现有业务\n- 适合将“PPT 转高精度图片”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/ppt-to-images", "operationId": "post_ppt_to_images", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ppt-to-images" }, "x-gugudata-api-identity": "ppt-to-images", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "请求参数字符串" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "转换后的图片总数" } }, "description": "接口业务状态信息。" }, "Data": { "type": "array", "items": { "type": "object" }, "description": "公开存储时返回文件下载地址列表；私有存储时返回文件引用列表，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/ppt-to-images/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "scale_factor", "in": "query", "required": false, "description": "图片导出缩放因子，默认为 1，最大为 4 倍高清模式", "schema": { "type": "number" }, "example": 1 } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "description": "PPT 文件，支持 .ppt 和 .pptx 格式" }, "url": { "type": "string", "description": "不传递 PPT 文件流，可直接传递可访问的 PPT 文件地址" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "file" ] }, "example": { "url": "", "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/ppt-to-pdf": { "post": { "summary": "PPT 转高精度 PDF", "description": "PPT 转 PDF，支持公开或私有存储\n接口标签：文件转换、PDF、超高精度与还原度\n接口特性：\n- 超高精度与还原度的 PDF 文件转换\n- 支持将 PPT 文件转换为 PDF 文档\n- 支持 .ppt 和 .pptx 格式\n- 保持原始 PPT 的布局、字体和样式\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“PPT 转高精度 PDF”提供标准化能力，便于快速接入现有业务\n- 适合将“PPT 转高精度 PDF”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/ppt-to-pdf", "operationId": "post_ppt_to_pdf", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ppt-to-pdf" }, "x-gugudata-api-identity": "ppt-to-pdf", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "请求参数字符串" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "公开存储时返回文件下载地址；私有存储时返回文件引用，可用于生成短期下载链接。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/ppt-to-pdf/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "description": "PPT 文件，支持 .ppt 和 .pptx 格式" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "file" ] }, "example": { "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/imagerecognition/word-to-html": { "post": { "summary": "Word 转 HTML", "description": "Word 转 HTML 文件\n接口标签：文件转换、Word、超高精度与还原度\n接口特性：\n- 超高精度与还原度的 HTML 文件转换\n- 支持将 Word 文档转换为 HTML 格式\n- 支持 .doc 和 .docx 格式\n- 保持原始 Word 文档的布局、字体和样式\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 提供 HTML 文件引用和内容\n- 接口服务多节点部署\n- 围绕“Word 转 HTML”提供标准化能力，便于快速接入现有业务\n详情页：https://www.gugudata.com/api/details/word-to-html", "operationId": "post_word_to_html", "tags": [ "图像/转换" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/word-to-html" }, "x-gugudata-api-identity": "word-to-html", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "请求参数字符串" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "html_url": { "type": "string", "description": "公开存储时返回 HTML 文件下载地址；私有存储时返回 HTML 文件引用，可用于生成短期下载链接。" }, "html_content": { "type": "string", "description": "转换后的 HTML 内容" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/imagerecognition/word-to-html/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "description": "Word 文档文件，支持 .doc 和 .docx 格式" }, "storage": { "type": "string", "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。" } }, "required": [ "file" ] }, "example": { "storage": "public" } } } }, "x-apifox-folder": "图像\\/转换" } }, "/location/chinaregions": { "get": { "summary": "全国省市区街道村信息", "description": "提供全国省市区街道居委会信息\n接口标签：基础数据、三种编码版本、全国最新最全数据\n接口特性：\n- 更新了最新的 12 位编码的行政区划编码格式\n- 三种行政区划编码格式，与国家规范一致，最新建议调用 v3 版本\n- 提供全国最新、最全的省市区镇街道区域信息\n- 每周校对、清洗、更新数据，第一时间同步更新区域信息变动\n- 可返回行政区划中心点地理坐标\n- 最小级别可以详细到镇、街道以及居委会/村级别，为国内区域单元最小级别\n- 围绕“全国省市区街道村信息”提供标准化能力，便于快速接入现有业务\n- 适合将“全国省市区街道村信息”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/chinaregions", "operationId": "get_chinaregions", "tags": [ "区域/坐标" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/chinaregions" }, "x-gugudata-api-identity": "chinaregions", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "RegionCode": { "type": "string", "description": "区域编码（在 v2 版本中，前六位为国家行政区划标准编码，镇/街道是没有国家标准编码的，对应的编码只是对应的序号。v3 版本中，为最新的 12 位国家行政区划标准编码。）" }, "RegionName": { "type": "string", "description": "区域名称（部分城市在“市”级别后没有“区”级别，会直接返回“镇/街道”信息，注意根据「区域级别」字段进行处理）" }, "RegionType": { "type": "string", "description": "区域级别，枚举值为：省/自治区/直辖市/特别行政区 | 市 | 区 | 镇/街道 ｜ 居委会/村" }, "CenterLonLat": { "type": "string", "description": "部分数据包含区划中心点坐标，格式为 [经度,纬度]，地理坐标系为 GCJ-02。需要转换坐标系请调用地理坐标系转换接口" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/location/chinaregions/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "regioncode", "in": "query", "required": true, "description": "需要查询的父级区域编码，传递 0 获取全国所有省级别数据；编码格式为 00000000，每两位分别对应省、市、区、镇/街道编码（注意：v2 版本会在国家 6 位行政区划标准代码后添加 00 两位编码以保持接口兼容，v3 版本为 12 位编码格式）", "schema": { "type": "string" }, "example": "YOUR_VALUE" }, { "name": "version", "in": "query", "required": true, "description": "当传递参数值为 2 时，调用 v2 版本的接口，regioncode 遵循国家行政区划代码标准，同时可返回新增区划中心点坐标。当传递参数值为 3 时，调用 v3 版本的接口（v1 版本主要为了兼容历史用户调用逻辑，新用户强烈建议调用 v3 接口）", "schema": { "type": "integer", "format": "int32" }, "example": 3 } ], "x-apifox-folder": "区域\\/坐标" } }, "/location/college": { "get": { "summary": "全国大学高校基础信息", "description": "全国高校基础信息查询\n接口标签：基础数据、高校高考、每周定时更新、高校各类属性\n接口特性：\n- 2026 年数据已更新\n- 提供最新全国高校学院基本信息\n- 总计近 4000 条全国高校精准数据\n- 每周一次数据自动更新校正\n- 包含高校各类属性、地理坐标、校徽图片、简称、旧称等信息\n- 包含高校开设专业列表\n- 毫秒级响应性能\n- 支持按全国排名升序或降序返回\n详情页：https://www.gugudata.com/api/details/college", "operationId": "get_college", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/college" }, "x-gugudata-api-identity": "college", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "array", "items": { "type": "object", "properties": { "DataId": { "type": "string", "description": "数据全局唯一 ID，仅用于标识数据的唯一" }, "SchoolUUID": { "type": "string", "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 历年高考高校录取分数线、历年高考专业录取分数线 接口中的 SchoolUUID 进行唯一匹配" }, "CollegeName": { "type": "string", "description": "学院名称" }, "Province": { "type": "string", "description": "学院所在省份" }, "City": { "type": "string", "description": "学院所在城市" }, "District": { "type": "string", "description": "学院所在区县" }, "Coordinate": { "type": "string", "description": "学院地理坐标经纬度，格式为 [经度,纬度]，地理坐标系为 GCJ-02。需要转换坐标系请调用 地理坐标系转换 接口" }, "CollegeType": { "type": "string", "description": "院校类型筛选，默认值为空，不进行筛选。当前可选值：专科（高职）、中外合作办学、中等专业学校、其它、普通本科、本科、独立学院。" }, "Is985": { "type": "boolean", "description": "是否为 985 院校" }, "Is211": { "type": "boolean", "description": "是否为 211 院校" }, "IsDualClass": { "type": "boolean", "description": "是否为双一流院校" }, "CollegeCategory": { "type": "string", "description": "院校类别筛选，默认值为空，不进行筛选。当前可选值：中职院校、体育类、其他、其它、军事类、农林类、医药类、师范类、政法类、民族类、理工类、综合类、艺术类、语言类、财经类。" }, "CollegeTags": { "type": "array", "items": { "type": "string" }, "description": "学院标签" }, "EduLevel": { "type": "string", "description": "院校学历层次筛选，默认值为空，不进行筛选。当前可选值：专科（中职）、专科（高职）、普通本科、本科。" }, "CollegeProperty": { "type": "string", "description": "院校办学性质筛选，默认值为空，不进行筛选。当前可选值：中外合作办学、公办、内地与港澳台地区合作办学、境外高校独立办学、民办、独立学院。" }, "CollegeCode": { "type": "string", "description": "学院编号" }, "Ranking": { "type": "integer", "format": "int32", "description": "全国排名，接口返回的数据结果默认按照此数值进行升序排列" }, "RankingInCategory": { "type": "string", "description": "学院所在类别下排名" }, "WebSite": { "type": "string", "description": "学院官网" }, "CallNumber": { "type": "string", "description": "学院招生电话" }, "Email": { "type": "string", "description": "学院招生邮箱" }, "Address": { "type": "string", "description": "学院地址" }, "BranchList": { "type": "array", "items": { "type": "string" }, "description": "主/分校区名称和地址" }, "CoverImage": { "type": "string", "description": "学院校徽" }, "Intro": { "type": "string", "description": "学院简介" }, "Expenses": { "type": "string", "description": "学院收费说明（Markdown 格式，仅供参考）" }, "OldName": { "type": "string", "description": "学院旧称" }, "ShortName": { "type": "string", "description": "学院简称" }, "MajorList": { "type": "object", "properties": { "MajorTitle": { "type": "string", "description": "开设专业大类" }, "Majors": { "type": "array", "items": { "type": "string" }, "description": "此大类下开设的专业" } } }, "AffiliatedTo": { "type": "string", "description": "隶属于" }, "IsMinistryOfEducationDirectlyAffiliated": { "type": "boolean", "description": "是否直属教育部" }, "NumMaster": { "type": "integer", "format": "int32", "description": "硕士点数量" }, "NumDoctor": { "type": "integer", "format": "int32", "description": "博士点数量" }, "GraduateRecommendationQualificationLevel": { "type": "integer", "format": "int32", "description": "研究生推免资格等级" }, "IsDeleted": { "type": "boolean", "description": "废弃数据标识" }, "DepartmentList": { "type": "array", "description": "当前已收录的完整院系列表，用于学校、学院（系）、专业三级联动；无有效数据时为空数组，不代表学校没有院系。", "items": { "type": "object", "required": [ "DepartmentName", "Majors" ], "properties": { "DepartmentName": { "type": "string", "description": "学院或系名称。" }, "Majors": { "type": "array", "description": "该院系所属专业列表；同一专业可能属于不同院系。", "items": { "type": "object", "required": [ "MajorName", "EduLevel" ], "properties": { "MajorName": { "type": "string", "description": "专业名称，保留来源公布的方向说明。" }, "EduLevel": { "type": "string", "description": "专业学历层次，例如本科、专科。" } } } } } } } }, "description": "接口返回的业务数据。" } } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/location/college/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "keywords", "in": "query", "required": true, "description": "搜索关键字，模糊匹配高校名称、省市区、高校旧称、地址字段，参数值为空则返回所有数据", "schema": { "type": "string" }, "example": "KEYWORDS" }, { "name": "uuid", "in": "query", "required": false, "description": "咕咕数据平台高校唯一 ID，可按响应字段 SchoolUUID 精确查询高校基础信息", "schema": { "type": "string" } }, { "name": "pagesize", "in": "query", "required": false, "description": "每页数据量，参数最大值为 20，用于控制分页", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "pageindex", "in": "query", "required": false, "description": "页码，第几页数据，用于控制分页", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "keywordstrict", "in": "query", "required": false, "description": "控制 keyword 参数在查询时是否进行模糊查询，true 为精确匹配高校名称，默认值为 false 进行模糊查询，可模糊匹配高校名称、省市区、高校旧称、地址字段。参数值为空则返回所有数据", "schema": { "type": "boolean" }, "example": false }, { "name": "collegecategory", "in": "query", "required": false, "description": "院校类别筛选，默认值为空，不进行筛选。当前可选值：中职院校、体育类、其他、其它、军事类、农林类、医药类、师范类、政法类、民族类、理工类、综合类、艺术类、语言类、财经类。", "schema": { "type": "string", "enum": [ "中职院校", "体育类", "其他", "其它", "军事类", "农林类", "医药类", "师范类", "政法类", "民族类", "理工类", "综合类", "艺术类", "语言类", "财经类" ] } }, { "name": "collegetype", "in": "query", "required": false, "description": "院校类型筛选，默认值为空，不进行筛选。当前可选值：专科（高职）、中外合作办学、中等专业学校、其它、普通本科、本科、独立学院。", "schema": { "type": "string", "enum": [ "专科（高职）", "中外合作办学", "中等专业学校", "其它", "普通本科", "本科", "独立学院" ] } }, { "name": "is985", "in": "query", "required": false, "description": "是否为 985 院校，需要参与查询则传参为：true", "schema": { "type": "boolean" }, "example": false }, { "name": "is211", "in": "query", "required": false, "description": "是否为 211 院校，需要参与查询则传参为：true", "schema": { "type": "boolean" }, "example": false }, { "name": "isdualclass", "in": "query", "required": false, "description": "是否为双一流院校，需要参与查询则传参为：true", "schema": { "type": "boolean" }, "example": false }, { "name": "edulevel", "in": "query", "required": false, "description": "院校学历层次筛选，默认值为空，不进行筛选。当前可选值：专科（中职）、专科（高职）、普通本科、本科。", "schema": { "type": "string", "enum": [ "专科（中职）", "专科（高职）", "普通本科", "本科" ] } }, { "name": "collegeproperty", "in": "query", "required": false, "description": "院校办学性质筛选，默认值为空，不进行筛选。当前可选值：中外合作办学、公办、内地与港澳台地区合作办学、境外高校独立办学、民办、独立学院。", "schema": { "type": "string", "enum": [ "中外合作办学", "公办", "内地与港澳台地区合作办学", "境外高校独立办学", "民办", "独立学院" ] } }, { "name": "sort", "in": "query", "required": false, "description": "返回数据排序方式，可选值：ranking|asc、ranking|desc；默认按全国排名升序。", "schema": { "type": "string", "enum": [ "ranking", "asc", "desc" ] }, "example": "ranking|asc" } ], "x-apifox-folder": "教育\\/高考" } }, "/location/coordinateconverter": { "get": { "summary": "地理坐标系转换", "description": "提供地理信息坐标系的相互转换\n接口标签：网络工具、地理坐标、支持 HTTPS、多种地理坐标系\n接口特性：\n- 支持多种地理信息坐标系\n- 高精度坐标系转换算法\n- 支持的地理坐标系：WGS84, GCJ02, BD09\n- 围绕“地理坐标系转换”提供标准化能力，便于快速接入现有业务\n- 适合将“地理坐标系转换”结果接入业务系统、后台工具和自动化流程\n- 适合地址解析、区域筛选、机构网点管理和地图类产品接入\n- 可与行政区划、坐标转换和 IP 定位接口组合使用\n- 支持按区域层级、坐标或网络地址组织查询结果\n详情页：https://www.gugudata.com/api/details/coordinateconverter", "operationId": "get_coordinateconverter", "tags": [ "区域/坐标" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/coordinateconverter" }, "x-gugudata-api-identity": "coordinateconverter", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "CoordinateFrom": { "type": "string", "description": "原数据的坐标系" }, "CoordinateTo": { "type": "string", "description": "目标数据的坐标系" }, "CoordinateSourceValue": { "type": "string", "description": "需要转换的坐标值" }, "CoordinateDestinationValue": { "type": "string", "description": "转换后的坐标值" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/location/coordinateconverter/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "from", "in": "query", "required": true, "description": "原数据的坐标系，可选值：WGS84, GCJ02, BD09", "schema": { "type": "string", "enum": [ "WGS84", "GCJ02", "BD09" ] }, "example": "YOUR_VALUE" }, { "name": "to", "in": "query", "required": true, "description": "目标数据的坐标系，可选值：WGS84, GCJ02, BD09", "schema": { "type": "string", "enum": [ "WGS84", "GCJ02", "BD09" ] }, "example": "YOUR_VALUE" }, { "name": "value", "in": "query", "required": true, "description": "需要转换的坐标值，格式为：[120.54,32.74]", "schema": { "type": "string" }, "example": "YOUR_VALUE" } ], "x-apifox-folder": "区域\\/坐标" } }, "/location/hospital-3a": { "get": { "summary": "全国三甲医院主体信息", "description": "按医院名称、别名和省市区查询三甲医院公开信息。\n详情页：https://www.gugudata.com/api/details/hospital-3a", "operationId": "get_hospital_3a", "tags": [ "区域/坐标" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/hospital-3a" }, "x-gugudata-api-identity": "hospital-3a", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "DataStatus", "Data" ], "properties": { "DataStatus": { "type": "object", "description": "接口业务状态信息。", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "additionalProperties": false, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ] }, "Data": { "type": "object", "description": "医院名录分页结果。", "additionalProperties": false, "required": [ "TotalCount", "PageIndex", "PageSize", "Items" ], "properties": { "TotalCount": { "type": "integer", "format": "int32", "minimum": 0, "description": "全部匹配数量。" }, "PageIndex": { "type": "integer", "format": "int32", "minimum": 1, "description": "当前页码。" }, "PageSize": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 100, "description": "每页数量。" }, "Items": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "Name", "Alias", "Province", "City", "District", "Address", "Telephone" ], "properties": { "Name": { "type": "string", "description": "医院名称。" }, "Alias": { "type": "string", "description": "医院别名，无数据时为空字符串。" }, "Province": { "type": "string", "description": "所在省份。" }, "City": { "type": "string", "description": "所在城市。" }, "District": { "type": "string", "description": "所在区县。" }, "Address": { "type": "string", "description": "医院地址，无数据时为空字符串。" }, "Telephone": { "type": "string", "description": "联系电话，无数据时为空字符串。" } } }, "description": "当前页医院列表。" } } } } } } } }, "400": { "description": "参数错误，业务码 501。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "缺少或无效 APPKEY，业务码 504。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "订单过期或额度不可用，业务码 503 或 505。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限，业务码 502。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误，业务码 900。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "503": { "description": "医院数据服务暂时不可用，业务码 901。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/location/hospital-3a/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": false, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "keyword", "in": "query", "required": false, "description": "医院名称或别名关键词。", "schema": { "type": "string", "maxLength": 100 } }, { "name": "province", "in": "query", "required": false, "description": "省份名称或简称。", "schema": { "type": "string", "maxLength": 32 } }, { "name": "city", "in": "query", "required": false, "description": "城市名称或简称。", "schema": { "type": "string", "maxLength": 32 } }, { "name": "district", "in": "query", "required": false, "description": "区县名称或简称。", "schema": { "type": "string", "maxLength": 32 } }, { "name": "pageIndex", "in": "query", "required": false, "description": "页码，从 1 开始。", "schema": { "type": "integer", "format": "int32", "minimum": 1, "default": 1 } }, { "name": "pageSize", "in": "query", "required": false, "description": "每页数量。", "schema": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 100, "default": 20 } } ], "x-apifox-folder": "区域\\/坐标", "security": [ { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] }, { "AppKeyQuery": [] } ] } }, "/metadata/ceecollegeline": { "get": { "summary": "历年高考高校录取分数线", "description": "高校在各省录取分数线\n接口标签：基础数据、高校高考、高校全量数据、可按省或高校查询\n接口特性：\n- 2026 年数据即将更新\n- 全国所有高校在全国各省的详细录取数据，从 2015 年至 2025 年\n- 百万级别已校对历史数据\n- 多种查询条件便于多维度分析\n- 数据持续自动更新与维护\n- 毫秒级查询性能\n- 围绕“历年高考高校录取分数线”提供标准化能力，便于快速接入现有业务\n- 适合将“历年高考高校录取分数线”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/ceecollegeline", "operationId": "get_ceecollegeline", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceecollegeline" }, "x-gugudata-api-identity": "ceecollegeline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "type": "string", "description": "请求参数，一般用于调试" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Province": { "type": "string", "description": "招生的省份" }, "SchoolUUID": { "type": "string", "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配" }, "CollegeName": { "type": "string", "description": "高校名称" }, "Year": { "type": "integer", "format": "int32", "description": "招生年份" }, "HighestScore": { "type": "string", "description": "录取最高分" }, "AverageScore": { "type": "string", "description": "录取平均分" }, "LowestScore": { "type": "string", "description": "录取最低分" }, "LowestRank": { "type": "string", "description": "录取最低位次" }, "ProvincialControlLine": { "type": "string", "description": "录取省控线" }, "EnrollmentType": { "type": "string", "description": "招生类型" }, "SelectionLevel": { "type": "string", "description": "选测等级（特定省）" }, "AdmissionBatch": { "type": "string", "description": "录取批次筛选，可使用英文逗号分隔传递多个值。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。" }, "TypeName": { "type": "string", "description": "科类筛选。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。" }, "CourseSelection": { "type": "string", "description": "选科要求" }, "CourseSelectionName": { "type": "string", "description": "专业组" }, "SchoolType": { "type": "string", "description": "学校类型，如公办、民办" }, "SchoolInCity": { "type": "string", "description": "高校所在的城市" }, "Is985": { "type": "boolean", "description": "是否为 985 院校" }, "Is211": { "type": "boolean", "description": "是否为 211 院校" }, "IsDualClass": { "type": "boolean", "description": "是否为双一流院校" }, "CoverImage": { "type": "string", "description": "高校 logo" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/ceecollegeline/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "searchtype", "in": "query", "required": true, "description": "查询条件类型，支持录取省份以及高校名称查询，参数值分别为：PROVINCENAME 或 COLLEGENAME", "schema": { "type": "string" } }, { "name": "keyword", "in": "query", "required": true, "description": "录取省份或高校名称，高校名称支持模糊查询。searchtype=PROVINCENAME 时传招生省份；searchtype=COLLEGENAME 时传高校名称。招生省份当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "pageindex", "in": "query", "required": true, "description": "分页参数，第几页", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pagesize", "in": "query", "required": true, "description": "分页参数，每页总条数，取值范围在 1 ~ 20 之间（含）", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "min", "in": "query", "required": false, "description": "录取最低分查询条件，筛选出最低分小于等于查询条件的值", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "type", "in": "query", "required": false, "description": "科类筛选。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, { "name": "keywordstrict", "in": "query", "required": false, "description": "控制 keyword 参数在查询高校名称时是否进行模糊查询，true 为精确匹配，默认值为 false 进行模糊查询", "schema": { "type": "string" }, "example": false }, { "name": "enrollprovince", "in": "query", "required": false, "description": "searchtype=COLLEGENAME 时附加招生省份筛选，例如江苏。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "batchname", "in": "query", "required": false, "description": "录取批次筛选，可使用英文逗号分隔传递多个值。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, { "name": "collegeprovincename", "in": "query", "required": false, "description": "院校所在省份筛选，例如江苏。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.collegeProvinceName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, { "name": "enrollmenttype", "in": "query", "required": false, "description": "招生类型筛选，例如普通类。可选值请通过 历年高考高校录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceecollegeline#anchor_related）（/metadata/ceecollegeline/enums）获取，使用返回字段 Data.enrollmentType。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceecollegeline/enums" }, { "name": "schooluuid", "in": "query", "required": false, "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/api/details/college" }, "x-gugudata-enum-source": "https://www.gugudata.com/api/details/college" }, { "name": "sort", "in": "query", "required": false, "description": "排序控制，格式为 字段|排序方向。未传 sort 时使用默认排序：min > 0 时按 LowestScore|desc、Year|desc；min 为空或 0 时按 Year|desc；同分或同年记录按系统稳定顺序补位。排序方向可选 asc、desc：asc 表示升序（从小到大），desc 表示降序（从大到小）。多个排序条件用英文逗号分隔，并按传入顺序依次排序。支持字段：HighestScore（录取最高分，对应返回字段 HighestScore）、AverageScore（录取平均分，对应 AverageScore）、LowestScore（录取最低分，对应 LowestScore）、LowestRank（录取最低位次，对应 LowestRank）、ProvincialControlLine（省控线，对应 ProvincialControlLine）、EnrollmentType（招生类型，对应 EnrollmentType）、SelectionLevel（选测等级，对应 SelectionLevel，主要用于特定省份历史数据）。示例：LowestScore|desc、LowestRank|asc、HighestScore|desc,LowestScore|desc。", "schema": { "type": "string" } }, { "name": "minrange", "in": "query", "required": false, "description": "录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700", "schema": { "type": "string" }, "example": 0 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceecollegeline/enums": { "get": { "summary": "历年高考高校录取分数线-查询参数枚举", "description": "返回 type、batchName、enrollmentType、collegeProvinceName 的枚举集合\n接口标签：基础数据、高校高考、高校全量数据、可按省或高校查询\n详情页：https://www.gugudata.com/api/details/ceecollegeline", "operationId": "get_get_metadata_ceecollegeline_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceecollegeline" }, "x-gugudata-api-identity": "ceecollegeline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "pre", "x-gugudata-parent-api-identity": "ceecollegeline", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/ceecollegeline", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": false, "description": "查询年份。当前可选值：2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" }, "example": 2025 }, { "name": "provinceName", "in": "query", "required": false, "description": "招生省份，可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、澳门、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" }, "example": "上海" } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceeline/one-score-one-section": { "get": { "summary": "历年高考一分一段数据", "description": "高考一分一段查询\n接口标签：基础数据、高校招生、多年历史记录、多纬度对比\n接口特性：\n- 2026 年数据已更新完毕\n- 历年数据第一时间手动校对更新\n- 支持全国各省份高考分数线一分一段表查询\n- 包含历年同分段与同位次分数对比数据\n- 支持物理类、历史类等不同科目选择类型\n- 支持按分数查询对应分数段和位次\n- 围绕“历年高考一分一段数据”提供标准化能力，便于快速接入现有业务\n- 适合将“历年高考一分一段数据”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/ceeline-one-score-one-section", "operationId": "get_ceeline_one_score_one_section", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section" }, "x-gugudata-api-identity": "ceeline-one-score-one-section", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "ExaminationScore": { "type": "string", "description": "高考分数" }, "CandidateCount": { "type": "integer", "format": "int32", "description": "该分数考生人数" }, "TotalCandidates": { "type": "integer", "format": "int32", "description": "累计考生人数" }, "RankingRange": { "type": "string", "description": "位次范围" }, "AdmissionBatchName": { "type": "string", "description": "录取批次名称" }, "MinimumAdmissionScore": { "type": "string", "description": "最低录取控制分数线" }, "Ranking": { "type": "string", "description": "位次" }, "HistoricalScores": { "type": "array", "items": { "type": "object" }, "description": "历年同分段数据" }, "HistoricalSameRankScores": { "type": "array", "items": { "type": "object" }, "description": "历年同位次分数" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "provinceName", "in": "query", "required": true, "description": "招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "subjectSelection", "in": "query", "required": true, "description": "科目选择类型筛选。可选值请通过 历年高考一分一段数据-查询参数枚举（https://www.gugudata.com/api/details/ceeline-one-score-one-section#anchor_related）（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.subjectSelection。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums" }, { "name": "isArtLine", "in": "query", "required": false, "description": "是否查询艺术类一分一段数据；true 表示查询艺术类，false 或不传表示查询普通类。", "schema": { "type": "boolean" }, "example": false }, { "name": "artLineType", "in": "query", "required": false, "description": "艺术类分数线类型，isArtLine=true 时可传。可选值请通过 历年高考一分一段数据-查询参数枚举（https://www.gugudata.com/api/details/ceeline-one-score-one-section#anchor_related）（/metadata/ceeline/one-score-one-section/enums）获取，使用返回字段 Data.artLineType。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceeline/one-score-one-section/enums", "example": "统考成绩排名" }, { "name": "pageIndex", "in": "query", "required": false, "description": "分页参数，第几页，默认值为1", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "分页参数，每页条数，取值范围在 1 ~ 100 之间（含）", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "score", "in": "query", "required": false, "description": "按高考分数查询对应分数段和位次，支持整数或小数；为空时返回分页列表。", "schema": { "type": "number" }, "example": 0 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceeline/one-score-one-section/enums": { "get": { "summary": "历年高考一分一段数据-查询参数枚举", "description": "兼容路由 https://api.gugudata.com/metadata/one-score-one-section/subject-selection-enums 仍可使用。\n接口标签：基础数据、高校招生、多年历史记录、多纬度对比\n详情页：https://www.gugudata.com/api/details/ceeline-one-score-one-section", "operationId": "get_get_metadata_ceeline_one_score_one_section_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section" }, "x-gugudata-api-identity": "ceeline-one-score-one-section", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "pre", "x-gugudata-parent-api-identity": "ceeline-one-score-one-section", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": false, "description": "查询年份。当前可选值：2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" }, "example": 2026 }, { "name": "provinceName", "in": "query", "required": false, "description": "招生省份，可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" }, "example": "上海" } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceemajor": { "get": { "summary": "全国大学高校专业数据", "description": "大学专业多维基础数据\n接口标签：基础数据、高校高考、持续更新、各类专业属性\n接口特性：\n- 提供最新全国高校专业基本信息\n- 数据定时自动更新与校正\n- 同时包含专业开设课程列表\n- 毫秒级响应性能\n- 围绕“全国大学高校专业数据”提供标准化能力，便于快速接入现有业务\n- 适合将“全国大学高校专业数据”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/ceemajor", "operationId": "get_ceemajor", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceemajor" }, "x-gugudata-api-identity": "ceemajor", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "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": "object", "properties": { "CourseName": { "type": "string", "description": "开设课程名称" }, "CourseDifficulty": { "type": "string", "description": "开设课程难度" } } }, "GraduateScale": { "type": "string", "description": "全国普通高校毕业生规模 （概略数据）" }, "MaleFemaleRatio": { "type": "string", "description": "男女比例 （概略数据）" }, "RecommendSchools": { "type": "array", "items": { "type": "string" }, "description": "推荐院校列表" }, "JobWorkingDetails": { "type": "array", "items": { "type": "string" }, "description": "工作职位推荐" }, "LimitYear": { "type": "string", "description": "学习年限" }, "Degree": { "type": "string", "description": "学位能力" }, "SpecialSchools": { "type": "array", "items": { "type": "string" }, "description": "专业顶尖高校" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/ceemajor/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "keywords", "in": "query", "required": false, "description": "搜索关键字，模糊匹配专业名称、学科、专业介绍、开设课程。参数值为空则分页返回所有数据", "schema": { "type": "string" } }, { "name": "pagesize", "in": "query", "required": false, "description": "每页数据量，参数最大值为 20", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "pageindex", "in": "query", "required": false, "description": "页码，第几页数据，第一页从 1 开始", "schema": { "type": "integer", "format": "int32" }, "example": 1 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceemajorline": { "get": { "summary": "历年高考专业录取分数线", "description": "高校专业各省录取分数线\n接口标签：基础数据、高校高考、复合查询条件、千万级数据\n接口特性：\n- 2026 年数据即将更新，每年数据定时更新\n- 全国高校各专业在全国各省的详细录取数据，从 2018 年至 2025 年\n- 一千多万条已智能校对数据\n- 提供按照高校分组的专业枚举信息前置查询接口\n- 在已有数据基础上，有定制化的接口也可联系我们\n- 多种查询参数条件便于多维度分析\n- 返回数据包含该专业录取的最低分、最高分、平均分、最低位次等信息\n- 数据持续更新与维护\n- 毫秒级查询性能\n详情页：https://www.gugudata.com/api/details/ceemajorline", "operationId": "get_ceemajorline", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceemajorline" }, "x-gugudata-api-identity": "ceemajorline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "DistinctSchoolCount": { "type": "integer", "format": "int32", "description": "此条件下的高校数量，一般用于展示多少高校符合筛选条件" }, "RequestParameter": { "type": "string", "description": "请求参数，一般用于调试" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "ProvinceName": { "type": "string", "description": "招生的省份" }, "SchoolUUID": { "type": "string", "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考高校录取分数线 接口中的 SchoolUUID 进行唯一匹配" }, "SchoolName": { "type": "string", "description": "高校名称" }, "MajorName": { "type": "string", "description": "专业名称" }, "MajorCode": { "type": "integer", "format": "int32", "description": "来源专业编号。表示原始数据来源中的专业 ID 或专业代码，不等同于教育部标准专业代码。" }, "Year": { "type": "integer", "format": "int32", "description": "招生年份" }, "HighSocre": { "type": "string", "description": "录取最高分，没有值时返回 '-'" }, "AverageScore": { "type": "string", "description": "录取平均分，没有值时返回 '-'" }, "LowestScore": { "type": "integer", "format": "int32", "description": "录取最低分" }, "LowestSection": { "type": "string", "description": "录取最低位次，没有值时返回 '-'" }, "BatchName": { "type": "string", "description": "专业录取批次筛选，多个值使用英文逗号分隔。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。" }, "TypeName": { "type": "string", "description": "科类筛选。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.typeName。请按查询年份 year 和招生省份 provinceName 获取适用取值。" }, "ProScore": { "type": "string", "description": "对应专业在对应省份录取的省控线，没有值时会返回 '-'" }, "subjectSelection": { "type": "string", "description": "选科要求数据" }, "SubjectGroup": { "type": "string", "description": "院校专业组。表示该专业所属的招生专业组或专业组编号，例如“(301)”。" }, "MajorStandardCode": { "type": "string", "description": "标准专业代码。表示教育部专业目录中的标准专业代码，主要用于和专业库、招生计划、专业录取分数线等数据做标准化关联；如果为空，通常表示该专业名称暂未能匹配到唯一标准代码，或该记录是大类、试验班等非单一标准专业。" }, "SpecialMajorCode": { "type": "string", "description": "招生专业代码。表示数据来源中的招生专业编号或院校专业编号，通常是学校或来源系统里的专业标识，不等同于教育部标准专业代码。" }, "major_category": { "type": "object", "additionalProperties": true, "description": "专业大类。表示原始专业名称中的大类、试验班、实验班、专业类、方向包等集合型专业名称；普通单专业一般为空。对象字段包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。" }, "included_majors": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "包含专业。表示从原始专业名称中拆解出的具体专业列表；数组元素包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。" }, "campus": { "type": "string", "description": "办学地点。表示校区、城市、学院地点等办学位置信息。" }, "special_requirements": { "type": "string", "description": "特殊要求。表示语种、性别、体检、收费、中外合作、师范、定向、专项、预科、订单培养等限制或说明。" }, "SchoolProvince": { "type": "string", "description": "院校所在省份" }, "SchoolCity": { "type": "string", "description": "院校所在城市" }, "SchoolCategory": { "type": "string", "description": "院校类型" }, "SchoolNature": { "type": "string", "description": "院校办学性质" }, "EducationLevel": { "type": "string", "description": "院校学历层次" }, "SchoolTags": { "type": "array", "items": { "type": "string" }, "description": "院校标签列表" } }, "description": "专业大类。表示原始专业名称中的大类、试验班、实验班、专业类、方向包等集合型专业名称；普通单专业一般为空。对象字段包含 name 和 code_candidate，其中 code_candidate 仅来自本地专业库唯一匹配结果，无法唯一匹配时为空。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/ceemajorline/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "pageindex", "in": "query", "required": true, "description": "分页参数，第几页", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pagesize", "in": "query", "required": true, "description": "分页参数，每页总条数，取值范围在 10 ~ 50 之间", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "enrollprovince", "in": "query", "required": false, "description": "招生省份筛选，例如江苏。enrollprovince、schoolname、majorname、specialId 四个参数不可同时为空。当前可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "schoolname", "in": "query", "required": false, "description": "高校名称 (enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)", "schema": { "type": "string" } }, { "name": "majorname", "in": "query", "required": false, "description": "专业名称，如电气工程与智能控制、计算机科学与技术等，默认为模糊搜索，可通过参数 majorNameStrict 控制。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)", "schema": { "type": "string" } }, { "name": "majorNameStrict", "in": "query", "required": false, "description": "控制参数 majorname 是否为严格匹配搜索，默认为 false，模糊搜索", "schema": { "type": "boolean" }, "example": false }, { "name": "specialId", "in": "query", "required": false, "description": "专业 Id，如 22748，用于精确控制搜索的专业。(enrollprovince、schoolname、majorname、specialId 四个参数都不是必选参数，但不可同时为空)", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "year", "in": "query", "required": true, "description": "必填，取值必须大于 0。查询年份。当前可选值：2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "min", "in": "query", "required": false, "description": "录取最低分查询条件，筛选出最低分小于等于查询条件的值。默认值为 0，不进行筛选", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "batchname", "in": "query", "required": false, "description": "专业录取批次筛选，多个值使用英文逗号分隔。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "typename", "in": "query", "required": false, "description": "科类筛选。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.typeName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string" } }, { "name": "schooluuid", "in": "query", "required": false, "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 全国大学高校基础信息、历年高考专业录取分数线 等接口中的 SchoolUUID 进行唯一匹配", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/api/details/college" }, "x-gugudata-enum-source": "https://www.gugudata.com/api/details/college" }, { "name": "minrange", "in": "query", "required": false, "description": "录取最低分区间查询条件，使用逗号分隔，左右都为闭区间，格式为：500,700", "schema": { "type": "string" } }, { "name": "subjectSelection", "in": "query", "required": false, "description": "选科要求筛选。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.subjectSelection。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "sort", "in": "query", "required": false, "description": "排序控制，格式为 字段|排序方向。未传 sort 时使用默认排序：min > 0 时按 LowestScore|desc、Year|desc；min 为空或 0 时按 Year|desc；同分或同年记录按系统稳定顺序补位。排序方向可选 asc、desc：asc 表示升序（从小到大），desc 表示降序（从大到小）。多个排序条件用英文逗号分隔，并按传入顺序依次排序。支持字段：HighestScore（录取最高分，对应返回字段 HighSocre）、AverageScore（录取平均分，对应 AverageScore）、LowestScore（录取最低分，对应 LowestScore）、LowestRank（录取最低位次，对应 LowestSection）、ProvincialControlLine（省控线，对应 ProScore）、EnrollmentType（招生类型，部分源数据有值）、SelectionLevel（选测等级，主要用于特定省份历史数据）。示例：LowestScore|desc、LowestRank|asc、HighestScore|desc,LowestScore|desc。", "schema": { "type": "string" } }, { "name": "excludeMajorCategory", "in": "query", "required": false, "description": "是否过滤专业大类数据，默认 false。传 true 时，过滤掉 MajorStandardCode 为空，或匹配 4 到 5 位大类编码的记录。", "schema": { "type": "boolean" }, "example": false }, { "name": "schoolRegions", "in": "query", "required": false, "description": "院校热门区域筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolRegions。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "schoolProvinces", "in": "query", "required": false, "description": "院校所在省份筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolProvinces。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "schoolCategories", "in": "query", "required": false, "description": "院校类型筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolCategories。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "schoolNatures", "in": "query", "required": false, "description": "院校办学性质筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolNatures。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "educationLevels", "in": "query", "required": false, "description": "院校学历层次筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.educationLevels。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, { "name": "schoolTags", "in": "query", "required": false, "description": "院校标签筛选，多个值使用英文逗号分隔，支持返回的代码或名称。可选值请通过 历年高考专业录取分数线-查询参数枚举（https://www.gugudata.com/api/details/ceemajorline#anchor_related）（/metadata/ceemajorline/enums）获取，使用返回字段 Data.schoolTags。同一筛选项内多个值取并集，不同筛选项之间取交集。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/ceemajorline/enums" } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceemajorline/enums": { "get": { "summary": "历年高考专业录取分数线-查询参数枚举", "description": "返回 batchName、typeName、subjectSelection，以及院校区域、省份、类型、办学性质、学历层次和院校标签等筛选枚举。\n接口标签：基础数据、高校高考、复合查询条件、千万级数据\n详情页：https://www.gugudata.com/api/details/ceemajorline", "operationId": "get_get_metadata_ceemajorline_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceemajorline" }, "x-gugudata-api-identity": "ceemajorline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "batchName": { "type": "array", "items": { "type": "string" } }, "typeName": { "type": "array", "items": { "type": "string" } }, "subjectSelection": { "type": "array", "items": { "type": "string" } }, "taxonomyVersion": { "type": "string" }, "taxonomyEffectiveFrom": { "type": "string" }, "schoolRegions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } }, "schoolProvinces": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } }, "schoolCategories": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } }, "schoolNatures": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } }, "educationLevels": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } }, "schoolTags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" }, "example": { "DataStatus": { "RequestParameter": "year=2025&provinceName=上海", "StatusCode": 100, "StatusDescription": "请求成功。", "ResponseDateTime": "2026-03-19 00:12:03.699", "DataTotalCount": 9 }, "Data": { "batchName": [ "专科批", "本科批" ], "typeName": [ "综合" ], "subjectSelection": [ "不限", "物理、化学(2科必选)" ], "taxonomyVersion": "2026.1", "taxonomyEffectiveFrom": "2026-07-20", "schoolRegions": [ { "code": "YANGTZE_RIVER_DELTA", "name": "长三角" } ], "schoolProvinces": [ { "code": "JIANGSU", "name": "江苏" } ], "schoolCategories": [ { "code": "COMPREHENSIVE", "name": "综合类" } ], "schoolNatures": [ { "code": "PUBLIC", "name": "公办" } ], "educationLevels": [ { "code": "UNDERGRADUATE", "name": "本科" } ], "schoolTags": [ { "code": "PROJECT_985", "name": "985" } ] } } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "related", "x-gugudata-parent-api-identity": "ceemajorline", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/ceemajorline", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": false, "description": "可选。按录取年份缩小批次、科类和选科枚举范围；不传时返回全部可用枚举。当前有数据的年份：2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。", "schema": { "type": "integer", "format": "int32" }, "example": 2025 }, { "name": "provinceName", "in": "query", "required": false, "description": "招生省份，可选值：上海、云南、内蒙古、北京、台湾、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、香港、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" }, "example": "上海" } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceemajorline/major-categories": { "get": { "summary": "历年高考专业录取分数线-专业类别", "description": "返回专业分类层级数据\n接口标签：基础数据、高校高考、复合查询条件、千万级数据\n详情页：https://www.gugudata.com/api/details/ceemajorline", "operationId": "get_get_metadata_ceemajorline_major_categories", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceemajorline" }, "x-gugudata-api-identity": "ceemajorline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "pre", "x-gugudata-parent-api-identity": "ceemajorline", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/ceemajorline", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "nameOrMd5Id", "in": "query", "required": false, "description": "nameOrMd5Id 支持学校名称或学校唯一 ID，year 为查询年份。", "schema": { "type": "string" }, "example": "NAME_OR_MD5ID" }, { "name": "year", "in": "query", "required": false, "description": "nameOrMd5Id 支持学校名称或学校唯一 ID，year 为查询年份。", "schema": { "type": "string" }, "example": "YEAR" } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/ceeprovince": { "get": { "summary": "历年高考省录取分数线", "description": "高考各批次省录取分数线\n接口标签：基础数据、高校高考、13年详细数据、定时持续更新\n接口特性：\n- 2026 年数据已更新完毕\n- 2014年 - 2026年全国各省高考录取数据\n- 完整录取批次数据\n- 多种搜索参数满足各类数据筛选需求\n- 数据持续定时自动更新\n- 围绕“历年高考省录取分数线”提供标准化能力，便于快速接入现有业务\n- 适合将“历年高考省录取分数线”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n详情页：https://www.gugudata.com/api/details/ceeprovince", "operationId": "get_ceeprovince", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceeprovince" }, "x-gugudata-api-identity": "ceeprovince", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Province": { "type": "string", "description": "录取省份" }, "Category": { "type": "string", "description": "录取科类筛选。当前可选值：3+证书、书法类、体育文、体育理、体育类、其他艺术、农学类、农林类、化工类、医学类、单独招生类、历史类、学考文、学考理、幼师类、广播电视编导类、建筑类、播音与主持类、文科、旅游类、机电类、汉授体育、汉授其他艺术、汉授编导、汉授美术、汉授音乐、汽驾类、烹饪类、牧医类、物理类、理科、畜牧兽医类、综合、美工设计类、美术类、舞蹈类、艺术文、艺术理、艺术类、蒙授体育、蒙授其他艺术、蒙授文科、蒙授理科、蒙授美术、蒙授艺术、蒙授音乐、蒙牧医类、计算机类、财会类、采矿类、音乐类。不同年份、省份下的数据覆盖可能不同。" }, "ScoreBatch": { "type": "string", "description": "录取批次。当前可选值：一类模式专科、一类模式本科、三校生专科、三校生本科、专科一批、专科二批、专科批、专科批（A类考生）、专科批（B类考生）、专科批（少数民族）、专科批（汉族）、专科批（独立学院、民办、省属高职除武汉）、专科提前批、专科院校卫生专项计划、中国消防救援学院、书法类（本科）、书法类（高职专科）、体育类一段、体育类一段（含专业成绩）、体育类二段、体育类二段（含专业成绩）、体育类本科批（少）、体育类本科批（汉）、体育类本科文化控制分数线、体育类高职（专科）文化控制分数线、体育类（专科）、体育类（平行录取一段）、体育类（平行录取二段）、体育类（普通类一段）、体育类（普通类二段）、体育类（本科一批）、体育类（本科三批）、体育类（本科二批）、体育类（本科批）、体育类（本科）、体育类（独立学院和民办本科）、体育类（第一段）、体育类（第二段）、体育类（高职专科）、军校军检线、军队提前本科批、军队本科批、单独招生批、国家、地方专项计划、国家专项计划批、国家专项计划本科一批、国家专项计划本科二批、国家贫困地区专项计划批、地方专项计划批、地方专项计划本科一批、地方专项计划本科二批、地方专项计划本科批、少数民族班、平行录取一段、平行录取三段、平行录取二段、广播电视编导类（本科）、广播电视编导类（高职专科）、戏曲类（本科）、戏曲类（高职专科）、播音与主持类（本科）、播音与主持类（高职专科）、教师专项计划、普通本科批、普通本科批（少）、普通本科（少数民族）、普通本科（汉族）、普通类一段、普通类二段、本科A段、本科B批、本科B段、本科一批、本科一批（A类考生）、本科一批（B类考生）、本科一段、本科三批、本科二批、本科二批C段、本科二批（A类考生）、本科二批（B类考生）、本科二段、本科批、本科批A段、本科批B段、本科批（少数民族）、本科批（汉族）、本科提前批、本科提前批A段、本科提前批B段、本科院校卫生专项计划、民族班及预科、特殊类型录取控制线（强基计划等）、特殊类型招生控制线、特殊类型资格线、省内专项、省内专项（本科一批）、省内专项（本科二批）、省内院校本科民族预科、省外院校民族班、民族预科（本科一批）、省外院校民族班、民族预科（本科二批）、美术与设计类（本科）、美术与设计类（高职专科）、美术类（本科）、美术类（高职专科）、自主招生控制分数线、自招线、舞蹈类（本科）、舞蹈类（高职专科）、艺体类（本科）、艺体类（高职专科）、艺术A类（本科）、艺术B类（本科）、艺术C类（本科）、艺术类本科批、艺术类本科批（少）、艺术类本科批（汉）、艺术类本科文化控制分数线、艺术类高职（专科）文化控制分数线、艺术类（专科提前批）、艺术类（专科）、艺术类（平行录取一段）、艺术类（平行录取二段）、艺术类（普通类一段）、艺术类（普通类二段）、艺术类（本科一批）、艺术类（本科三批）、艺术类（本科二批A段）、艺术类（本科二批B段）、艺术类（本科二批）、艺术类（本科批）、艺术类（本科提前批）、艺术类（本科）、艺术类（独立学院和民办本科）、艺术类（第一段）、艺术类（第二段）、艺术类（高职专科批）、艺术类（高职专科）、蒙授本科一批、蒙授本科二批、蒙授高职高专、表（导）演类（本科）、表（导）演类（高职专科）、贫困地区专项计划（本科一批）、贫困地区专项计划（本科二批）、部队生源招生本科控制线、重点本科批、重点本科批（少）、重点本科（少数民族）、重点本科（汉族）、音乐类（本科）、音乐类（高职专科）、预科班、高分优先投档批、高分优先投档线、高本贯通批、高水平运动队、高职（专科）批。具体批次随年份、省份和科类而异。" }, "Year": { "type": "integer", "format": "int32", "description": "录取年份，2014年 - 2026年" }, "Score": { "type": "integer", "format": "int32", "description": "录取分数线" }, "SpecialName": { "type": "string", "description": "专业说明，如 艺术类（平行录取一段）-音乐类音乐教育声乐主项，如果没有那么值为 null" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/ceeprovince/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "keyword", "in": "query", "required": true, "description": "录取省份搜索关键字，例如江苏；为空返回所有数据。省份当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": false, "description": "查询年份。当前可选值：2014、2015、2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "category", "in": "query", "required": false, "description": "录取科类筛选。当前可选值：3+证书、书法类、体育文、体育理、体育类、其他艺术、农学类、农林类、化工类、医学类、单独招生类、历史类、学考文、学考理、幼师类、广播电视编导类、建筑类、播音与主持类、文科、旅游类、机电类、汉授体育、汉授其他艺术、汉授编导、汉授美术、汉授音乐、汽驾类、烹饪类、牧医类、物理类、理科、畜牧兽医类、综合、美工设计类、美术类、舞蹈类、艺术文、艺术理、艺术类、蒙授体育、蒙授其他艺术、蒙授文科、蒙授理科、蒙授美术、蒙授艺术、蒙授音乐、蒙牧医类、计算机类、财会类、采矿类、音乐类。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string", "enum": [ "3+证书", "书法类", "体育文", "体育理", "体育类", "其他艺术", "农学类", "农林类", "化工类", "医学类", "单独招生类", "历史类", "学考文", "学考理", "幼师类", "广播电视编导类", "建筑类", "播音与主持类", "文科", "旅游类", "机电类", "汉授体育", "汉授其他艺术", "汉授编导", "汉授美术", "汉授音乐", "汽驾类", "烹饪类", "牧医类", "物理类", "理科", "畜牧兽医类", "综合", "美工设计类", "美术类", "舞蹈类", "艺术文", "艺术理", "艺术类", "蒙授体育", "蒙授其他艺术", "蒙授文科", "蒙授理科", "蒙授美术", "蒙授艺术", "蒙授音乐", "蒙牧医类", "计算机类", "财会类", "采矿类", "音乐类" ] } } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/college-enrollment-plan": { "get": { "summary": "历年高校招生计划数据", "description": "各高校历年招生计划数据\n接口标签：基础数据、高校招生、高校招生数据、历年计划\n接口特性：\n- 2026 年数据已更新完毕\n- 支持历年高校招生计划数据查询，包含 2018 年至 2026 年数据\n- 包含各高校招生计划详细数据，百万级数据\n- 多维度查询条件支持\n- 毫秒级查询性能\n- 围绕“历年高校招生计划数据”提供标准化能力，便于快速接入现有业务\n- 适合将“历年高校招生计划数据”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n详情页：https://www.gugudata.com/api/details/collegeenrollmentplan", "operationId": "get_collegeenrollmentplan", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/collegeenrollmentplan" }, "x-gugudata-api-identity": "collegeenrollmentplan", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求参数字符串。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码。" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "DataId": { "type": "string", "description": "招生计划明细唯一标识。" }, "InSchoolYears": { "type": "string", "description": "学制年限。" }, "ClassOne": { "type": "string", "description": "专业门类/一级分类。" }, "ClassTwo": { "type": "string", "description": "专业类/二级分类。" }, "BatchName": { "type": "string", "description": "录取批次名称。" }, "Type": { "type": "string", "description": "招生科类/选科类型。" }, "SchoolName": { "type": "string", "description": "高校名称。" }, "RecruitCode": { "type": "string", "description": "院校招生代码。" }, "EnrollmentNumbers": { "type": "string", "description": "计划招生人数。" }, "SchoolUUID": { "type": "string", "description": "高校唯一标识。" }, "CourseSelectionRequirements": { "type": "string", "description": "选科要求。" }, "CollegeMajorName": { "type": "string", "description": "招生计划中的专业名称与说明。" }, "ShortCollegeMajorName": { "type": "string", "description": "专业名称短名称。" }, "CollegeMajorCode": { "type": "string", "description": "标准专业代码/专业目录代码；部分源数据可能为空或不适用。" }, "LocalMajorCode": { "type": "string", "description": "招生目录中的本地专业代码；不等同于 CollegeMajorCode 标准专业代码。" }, "major_category": { "type": "object", "additionalProperties": true, "description": "AI 解析的专业分类结果。" }, "included_majors": { "type": "array", "items": { "type": "object" }, "description": "AI 解析出的包含专业列表。" }, "campus": { "type": "string", "description": "AI 解析出的校区信息。" }, "special_requirements": { "type": "string", "description": "AI 解析出的特殊要求。" }, "Tuition": { "type": "string", "description": "学费，单位通常为元/学年；以源数据文本为准。" }, "Year": { "type": "integer", "format": "int32", "description": "招生年份。" }, "ProvinceName": { "type": "string", "description": "招生省份。" }, "SpecialGroup": { "type": "string", "description": "专业组/招生组标识；为空表示该省份或批次不适用。" }, "SpecialCode": { "type": "string", "description": "招生计划明细中的专业代码/专业组内代码；不等同于标准专业代码。" }, "SpecialGroupName": { "type": "string", "description": "专业组名称，例如（03）。" } }, "description": "AI 解析的专业分类结果。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/college-enrollment-plan/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "collegemajorname", "in": "query", "required": false, "description": "查询的高校专业名称，支持模糊查询。", "schema": { "type": "string" } }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "pageIndex", "in": "query", "required": true, "description": "分页页码，从 1 开始。", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": true, "description": "每页数量，取值范围为 1~100。", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "schoolname", "in": "query", "required": false, "description": "高校名称，支持模糊查询。", "schema": { "type": "string" } }, { "name": "provincename", "in": "query", "required": false, "description": "招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "classone", "in": "query", "required": false, "description": "专业门类/一级分类筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.classone。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, { "name": "classtwo", "in": "query", "required": false, "description": "专业类/二级分类筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.classtwo。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, { "name": "batchname", "in": "query", "required": false, "description": "录取批次筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, { "name": "type", "in": "query", "required": false, "description": "科类/选科类型筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/college-enrollment-plan/enums" }, { "name": "schooluuid", "in": "query", "required": false, "description": "高校唯一标识，适合与高校基础数据、分数线接口进行关联。", "schema": { "type": "string" } }, { "name": "minTuition", "in": "query", "required": false, "description": "最低学费筛选，单位通常为元/学年；为空时不筛选。", "schema": { "type": "number" }, "example": 0 }, { "name": "maxTuition", "in": "query", "required": false, "description": "最高学费筛选，单位通常为元/学年；为空时不筛选。", "schema": { "type": "number" }, "example": 0 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/college-enrollment-plan/enums": { "get": { "summary": "历年高校招生计划数据-查询参数枚举", "description": "查询指定年份和省份下招生计划可用的专业门类、专业类、批次、科类和选科枚举。\n接口标签：基础数据、高校招生、高校招生数据、历年计划\n详情页：https://www.gugudata.com/api/details/collegeenrollmentplan", "operationId": "get_get_metadata_college_enrollment_plan_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/collegeenrollmentplan" }, "x-gugudata-api-identity": "collegeenrollmentplan", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "classone": { "type": "array", "items": { "type": "string" } }, "classtwo": { "type": "array", "items": { "type": "string" } }, "batchName": { "type": "array", "items": { "type": "string" } }, "type": { "type": "array", "items": { "type": "string" } }, "subjectSelection": { "type": "array", "items": { "type": "string" } } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "related", "x-gugudata-parent-api-identity": "collegeenrollmentplan", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/collegeenrollmentplan", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "provinceName", "in": "query", "required": true, "description": "招生省份，可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/college-enrollment-plan/recruit-codes": { "get": { "summary": "历年高校招生计划数据-院校招生代码查询", "description": "查询指定年份、招生省份、批次、科类和院校对应的院校招生代码，并返回计划招生人数、专业数量及内部招生专业代码，便于和招生计划明细一起核验。 返回字段 RecruitCodeReason 用于说明同一院校不同院校代码的区分原因。\n接口标签：基础数据、高校招生、高校招生数据、历年计划\n详情页：https://www.gugudata.com/api/details/collegeenrollmentplan", "operationId": "get_get_metadata_college_enrollment_plan_recruit_codes", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/collegeenrollmentplan" }, "x-gugudata-api-identity": "collegeenrollmentplan", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "string", "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "related", "x-gugudata-parent-api-identity": "collegeenrollmentplan", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/collegeenrollmentplan", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "provinceName", "in": "query", "required": false, "description": "招生省份，可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、新疆、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、西藏、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "batchName", "in": "query", "required": false, "description": "录取批次筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.batchName。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string" } }, { "name": "typeName", "in": "query", "required": false, "description": "科类/选科类型筛选。可选值请通过 历年高校招生计划数据-查询参数枚举（https://www.gugudata.com/api/details/collegeenrollmentplan#anchor_related）（/metadata/college-enrollment-plan/enums）获取，使用返回字段 Data.type。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string" } }, { "name": "schoolName", "in": "query", "required": false, "description": "高校名称，支持按高校名称查询。", "schema": { "type": "string" } }, { "name": "schoolUuid", "in": "query", "required": false, "description": "咕咕数据平台高校唯一 ID。", "schema": { "type": "string" } }, { "name": "recruitCode", "in": "query", "required": false, "description": "院校招生代码，如 4375。", "schema": { "type": "string" } }, { "name": "pageIndex", "in": "query", "required": false, "description": "分页参数，第几页，默认值为 1。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "pageSize", "in": "query", "required": false, "description": "分页参数，每页条数，取值范围为 1~100。", "schema": { "type": "integer", "format": "int32" }, "example": 0 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/global-university-ranking": { "get": { "summary": "全球 QS 世界大学排名数据", "description": "QS 世界大学排名数据检索\n接口标签：高等教育、全球排名\n接口特性：\n- 覆盖 QS 世界大学综合排名数据，数据总量以 DataStatus.DataTotalCount 为准\n- 支持英文校名、中文校名及常见国家、城市中文别名搜索，例如 MIT、清华、美国、伦敦\n- 返回综合排名、地区、国家、城市、学校 Logo，以及学术声誉、雇主声誉、师生比例、论文引用、就业成果、国际化、可持续发展等排名与得分\n- pageIndex 从 1 开始，pageSize 取值范围 1~20\n- 围绕“全球 QS 世界大学排名数据”提供标准化能力，便于快速接入现有业务\n- 适合将“全球 QS 世界大学排名数据”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/global-university-ranking", "operationId": "get_global_university_ranking", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/global-university-ranking" }, "x-gugudata-api-identity": "global-university-ranking", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要字符串。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码。" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Id": { "type": "string", "description": "咕咕数据平台大学唯一标识。" }, "UniversityName": { "type": "string", "description": "大学英文名称。" }, "UniversityChineseName": { "type": "string", "description": "大学中文名称，海外大学中文译名仅供参考，以英文名称为准。" }, "Region": { "type": "string", "description": "所在大洲或区域。" }, "Country": { "type": "string", "description": "所在国家或地区。" }, "City": { "type": "string", "description": "所在城市。" }, "LogoUrl": { "type": "string", "description": "大学 Logo 图片地址。" }, "Rank": { "type": "string", "description": "QS 综合排名；可能包含并列或区间排名文本，以字符串返回。" }, "AcademicReputationRank": { "type": "string", "description": "学术声誉指标排名。" }, "AcademicReputationScore": { "type": "string", "description": "学术声誉指标得分。" }, "CitationsPerFacultyRank": { "type": "string", "description": "篇均教员引用指标排名。" }, "CitationsPerFacultyScore": { "type": "string", "description": "篇均教员引用指标得分。" }, "FacultyStudentRatioRank": { "type": "string", "description": "师生比例指标排名。" }, "FacultyStudentRatioScore": { "type": "string", "description": "师生比例指标得分。" }, "EmployerReputationRank": { "type": "string", "description": "雇主声誉指标排名。" }, "EmployerReputationScore": { "type": "string", "description": "雇主声誉指标得分。" }, "EmploymentOutcomesRank": { "type": "string", "description": "就业成果指标排名。" }, "EmploymentOutcomesScore": { "type": "string", "description": "就业成果指标得分。" }, "InternationalStudentRatioRank": { "type": "string", "description": "国际学生比例指标排名。" }, "InternationalStudentRatioScore": { "type": "string", "description": "国际学生比例指标得分。" }, "InternationalResearchNetworkRank": { "type": "string", "description": "国际研究网络指标排名。" }, "InternationalResearchNetworkScore": { "type": "string", "description": "国际研究网络指标得分。" }, "InternationalFacultyRatioRank": { "type": "string", "description": "国际教师比例指标排名。" }, "InternationalFacultyRatioScore": { "type": "string", "description": "国际教师比例指标得分。" }, "SustainabilityRank": { "type": "string", "description": "可持续发展指标排名。" }, "SustainabilityScore": { "type": "string", "description": "可持续发展指标得分。" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/global-university-ranking/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "name", "in": "query", "required": false, "description": "学校名称关键词，支持英文校名、中文校名以及部分国家、城市中文别名模糊搜索；不传则返回全部排名数据。例如：MIT、清华、美国、London。", "schema": { "type": "string" } }, { "name": "pageIndex", "in": "query", "required": false, "description": "分页页码，从 1 开始，默认值为 1。", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "每页返回条数，默认值为 10，取值范围为 1~20。", "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/middle-school": { "get": { "summary": "全国中学基础信息", "description": "提供全国初级高级中学基础数据\n接口标签：基础数据、高校高考、定时更新、多维度筛选\n接口特性：\n- 2026 年数据已更新，提供最新全国中学学校基本信息\n- 包含全国初级中学与高等中学\n- 总计近 10 万条全国中学精准数据\n- 每月一次数据自动更新校正\n- 包含学校各类属性信息\n- 毫秒级响应性能\n- 围绕“全国中学基础信息”提供标准化能力，便于快速接入现有业务\n- 适合将“全国中学基础信息”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/middleschool", "operationId": "get_middleschool", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/middleschool" }, "x-gugudata-api-identity": "middleschool", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "接口请求参数" }, "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Id": { "type": "string", "description": "数据全局唯一 ID，仅用于标识数据的唯一" }, "SchoolName": { "type": "string", "description": "中学学校名称" }, "SchoolType": { "type": "string", "description": "中学类型" }, "Province": { "type": "string", "description": "学校所在省份" }, "City": { "type": "string", "description": "学校所在城市" }, "District": { "type": "string", "description": "学校所在区县" }, "Address": { "type": "string", "description": "学校地址" }, "PostalCode": { "type": "string", "description": "学校邮政编码" }, "PhoneCode": { "type": "string", "description": "学校电话区号" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/middle-school/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "pageIndex", "in": "query", "required": true, "description": "页码，第几页数据", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": true, "description": "每页数据量，参数最大值为 20", "schema": { "type": "integer", "format": "int32" }, "example": 10 }, { "name": "schoolType", "in": "query", "required": false, "description": "中学类型：ALL (不限制) | MIDDLE_SCHOOL (初级中学) | HIGH_SCHOOL (高级中学)", "schema": { "type": "string" }, "example": "ALL" }, { "name": "schoolName", "in": "query", "required": false, "description": "学校名称，模糊搜索，参数默认值为空，不进行筛选", "schema": { "type": "string" } }, { "name": "provinceName", "in": "query", "required": false, "description": "学校所在省份，参数默认值为空，不进行筛选", "schema": { "type": "string" } }, { "name": "cityName", "in": "query", "required": false, "description": "学校所在城市，参数默认值为空，不进行筛选", "schema": { "type": "string" } } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/one-score-one-section/subject-selection-enums": { "get": { "summary": "历年高考一分一段数据-科目类型枚举（兼容路由）", "description": "兼容路由，返回按省份与年份组织的 subjectSelection 枚举数据。\n接口标签：基础数据、高校招生、多年历史记录、多纬度对比\n详情页：https://www.gugudata.com/api/details/ceeline-one-score-one-section", "operationId": "get_get_metadata_one_score_one_section_subject_selection_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section" }, "x-gugudata-api-identity": "ceeline-one-score-one-section", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "上海": { "type": "object", "properties": { "2026": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" } } } } } } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "related", "x-gugudata-parent-api-identity": "ceeline-one-score-one-section", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/ceeline-one-score-one-section", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2016、2017、2018、2019、2020、2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "provinceName", "in": "query", "required": true, "description": "招生省份，可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、江西、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、贵州、辽宁、重庆、陕西、青海、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/postgraduate-national-score-line": { "get": { "summary": "研究生招生国家分数线", "description": "历年考研国家线与分类查询。\n- 查询 2001—2026 年研究生招生考试国家线；\n- 按考试年份检索历年分数要求；\n- 支持学科门类、专业类别及政策名称关键词查询；\n- 支持统一划线、单独划线和专项政策等类型筛选；\n- 对有学位分类的年份支持学术与专业学位筛选；\n- 保留各年份实际使用的地区与历史考生分类；\n- 返回总分及两类单科成绩要求；\n- 保留自主确定等文字要求，避免误读政策；\n- 支持分页与匹配总数，便于检索和历年对照；\n- 仅提供国家线，学校复试要求需另行核实。\n未知或重复业务参数返回 501；多个鉴权位置同值允许，冲突返回 501。", "operationId": "get_postgraduatenationalscoreline", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/postgraduatenationalscoreline" }, "x-gugudata-api-identity": "postgraduatenationalscoreline", "x-gugudata-business-status-codes": [ { "code": "100", "title": "成功", "remark": "HTTP 200" }, { "code": "501", "title": "参数或凭证冲突", "remark": "HTTP 400" }, { "code": "502", "title": "请求频率受限", "remark": "HTTP 429" }, { "code": "503", "title": "订单到期", "remark": "HTTP 403" }, { "code": "504", "title": "APPKEY 缺失或无效", "remark": "HTTP 401" }, { "code": "505", "title": "额度耗尽", "remark": "HTTP 403" }, { "code": "900", "title": "内部错误", "remark": "HTTP 500" }, { "code": "901", "title": "国家线数据服务暂不可用", "remark": "HTTP 503" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 100 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "array", "items": { "type": "object", "properties": { "Year": { "type": "integer", "minimum": 2001, "maximum": 2026 }, "LineScope": { "type": "string" }, "DisciplineCategoryName": { "type": "string" }, "CandidateRegion": { "type": "string" }, "TotalScore": { "type": "integer", "minimum": 0 }, "SingleSubject100Text": { "type": "string", "description": "单科成绩要求原文；保留招生单位自主确定等文字及历史合法空字符串。" }, "SingleSubjectOver100Text": { "type": "string", "description": "单科成绩要求原文；保留招生单位自主确定等文字及历史合法空字符串。" } }, "required": [ "Year", "LineScope", "DisciplineCategoryName", "CandidateRegion", "TotalScore", "SingleSubject100Text", "SingleSubjectOver100Text" ], "additionalProperties": false } } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false }, "example": { "DataStatus": { "RequestParameter": "year=2026&disciplineLength=2&scopeLength=16°reeLength=0®ionLength=0&pageindex=1&pagesize=10", "StatusCode": 100, "StatusDescription": "请求成功。", "ResponseDateTime": "2026-09-07 12:00:00", "DataTotalCount": 2 }, "Data": [ { "Year": 2026, "LineScope": "国家线-按学科门类统一划线", "DisciplineCategoryName": "哲学", "CandidateRegion": "A区", "TotalScore": 326, "SingleSubject100Text": "41", "SingleSubjectOver100Text": "62" }, { "Year": 2026, "LineScope": "国家线-按学科门类统一划线", "DisciplineCategoryName": "哲学", "CandidateRegion": "B区", "TotalScore": 316, "SingleSubject100Text": "38", "SingleSubjectOver100Text": "57" } ] } } } }, "400": { "description": "参数或凭证冲突", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 501 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "401": { "description": "APPKEY 缺失或无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 504 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "403": { "description": "订单到期 / 额度耗尽", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 503, 505 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "429": { "description": "请求频率受限", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 502 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "500": { "description": "内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 900 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "503": { "description": "国家线数据服务暂不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 901 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/postgraduate-national-score-line/demo" }, "parameters": [ { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 2001, "maximum": 2026, "default": 2026 }, "description": "考试年份，2001—2026；超出范围或非整数返回 501。" }, { "name": "disciplineCategoryName", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 100, "default": "" }, "description": "学科门类、专业类别或政策名称关键词；默认不筛选。" }, { "name": "lineScope", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "", "enum": [ "", "national_unified", "unified", "学科门类", "统一划线", "国家线-按学科门类统一划线", "national_separate", "separate", "单独划线", "国家线-单独划线学科专业", "national_special", "special", "专项计划", "照顾政策", "国家线-专项计划和照顾政策", "national_academic", "academic", "学术学位", "国家线-学术学位", "national_professional", "professional", "专业学位", "国家线-专业学位" ] }, "description": "国家线类型；接受所列中文及英文别名，英文不区分大小写；默认不筛选。" }, { "name": "degreeType", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "", "enum": [ "", "academic", "xs", "学术", "学术学位", "professional", "zyxw", "专业", "专业学位" ] }, "description": "仅筛选原有学位分类，不推断分类；2026 年 academic 无匹配。默认不筛选。" }, { "name": "candidateRegion", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "" }, "description": "A/A区/一区、B/B区/二区支持别名；C区、应届生、往届生及历史复合分类按返回值原样筛选。默认不筛选。" }, { "name": "pageindex", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 2147483647, "default": 1 }, "description": "页码从 1 开始，超出结果范围返回空数组及完整匹配总数。" }, { "name": "pagesize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 }, "description": "每页 1～20 条，默认 10。" } ], "x-apifox-folder": "教育\\/高考", "security": [ { "AppKeyQuery": [] }, { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] } ] } }, "/metadata/postgraduate-program": { "get": { "summary": "研究生招生专业目录", "description": "考研招生专业与考试科目查询。\n- 查询 2026 年研究生招生专业目录；\n- 按招生单位代码、名称或关联高校 ID 检索；\n- 支持省份、专业代码与专业名称组合筛选；\n- 支持学术及专业学位、全日制及非全日制筛选；\n- 可按双一流和自主划线招生单位条件筛选；\n- 返回院系、专业、研究方向及考试方式；\n- 展示考试科目组合、导师信息与拟招生人数说明；\n- 提供可获取且年份匹配的招生简章资料；\n- 支持分页与匹配总数，便于择校检索和专业对照；\n- 招生安排可能调整，报考前请核对招生单位公告。\n未知或重复业务参数返回 501；多个鉴权位置同值允许，冲突返回 501。", "operationId": "get_postgraduateprogram", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/postgraduateprogram" }, "x-gugudata-api-identity": "postgraduateprogram", "x-gugudata-business-status-codes": [ { "code": "100", "title": "成功", "remark": "HTTP 200" }, { "code": "501", "title": "参数或凭证冲突", "remark": "HTTP 400" }, { "code": "502", "title": "请求频率受限", "remark": "HTTP 429" }, { "code": "503", "title": "订单到期", "remark": "HTTP 403" }, { "code": "504", "title": "APPKEY 缺失或无效", "remark": "HTTP 401" }, { "code": "505", "title": "额度耗尽", "remark": "HTTP 403" }, { "code": "900", "title": "内部错误", "remark": "HTTP 500" }, { "code": "901", "title": "招生目录服务暂不可用", "remark": "HTTP 503" } ], "responses": { "200": { "description": "成功", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 100 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "array", "items": { "type": "object", "properties": { "Year": { "type": "integer", "minimum": 1, "maximum": 2147483647 }, "SchoolUUID": { "type": "string", "description": "未提供或不适用时为空字符串，不推断补写。" }, "SchoolCode": { "type": "string" }, "SchoolName": { "type": "string" }, "Province": { "type": "string" }, "City": { "type": "string" }, "CoverImage": { "type": "string" }, "IsDoubleFirstClass": { "type": "boolean" }, "HasGraduateSchool": { "type": "boolean" }, "IsSelfMarking": { "type": "boolean" }, "DepartmentName": { "type": "string" }, "MajorCode": { "type": "string" }, "MajorName": { "type": "string" }, "DegreeType": { "type": "string" }, "DisciplineCategoryCode": { "type": "string" }, "DisciplineCategoryName": { "type": "string" }, "FirstLevelDisciplineCode": { "type": "string" }, "FirstLevelDisciplineName": { "type": "string" }, "DirectionName": { "type": "string" }, "StudyMode": { "type": "string" }, "ExamMethod": { "type": "string" }, "Advisor": { "type": "string" }, "PlannedEnrollmentText": { "type": "string", "description": "拟招生人数原文，不代表每个研究方向分别拥有此人数。" }, "Remark": { "type": "string" }, "ExamSubjectGroups": { "type": "array", "items": { "type": "object", "properties": { "Subject1": { "type": "object", "properties": { "Code": { "type": "string" }, "Name": { "type": "string" }, "Description": { "type": "string" } }, "required": [ "Code", "Name", "Description" ], "additionalProperties": false }, "Subject2": { "type": "object", "properties": { "Code": { "type": "string" }, "Name": { "type": "string" }, "Description": { "type": "string" } }, "required": [ "Code", "Name", "Description" ], "additionalProperties": false }, "Subject3": { "type": "object", "properties": { "Code": { "type": "string" }, "Name": { "type": "string" }, "Description": { "type": "string" } }, "required": [ "Code", "Name", "Description" ], "additionalProperties": false }, "Subject4": { "type": "object", "properties": { "Code": { "type": "string" }, "Name": { "type": "string" }, "Description": { "type": "string" } }, "required": [ "Code", "Name", "Description" ], "additionalProperties": false } }, "required": [ "Subject1", "Subject2", "Subject3", "Subject4" ], "additionalProperties": false } }, "BrochureTitle": { "type": "string", "description": "未提供或不适用时为空字符串，不推断补写。" }, "BrochurePublishedDate": { "type": "string", "description": "未提供或不适用时为空字符串，不推断补写。" }, "BrochureSummary": { "type": "string", "description": "未提供或不适用时为空字符串，不推断补写。" } }, "required": [ "Year", "SchoolUUID", "SchoolCode", "SchoolName", "Province", "City", "CoverImage", "IsDoubleFirstClass", "HasGraduateSchool", "IsSelfMarking", "DepartmentName", "MajorCode", "MajorName", "DegreeType", "DisciplineCategoryCode", "DisciplineCategoryName", "FirstLevelDisciplineCode", "FirstLevelDisciplineName", "DirectionName", "StudyMode", "ExamMethod", "Advisor", "PlannedEnrollmentText", "Remark", "ExamSubjectGroups", "BrochureTitle", "BrochurePublishedDate", "BrochureSummary" ], "additionalProperties": false } } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false }, "example": { "DataStatus": { "StatusCode": 100, "RequestParameter": "year=2026&schoolNameLength=4&majorNameLength=2&pageindex=1&pagesize=10", "StatusDescription": "请求成功。", "ResponseDateTime": "2026-09-07 14:46:01.953", "DataTotalCount": 11 }, "Data": [ { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010101", "MajorName": "马克思主义哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "当代中国马克思主义哲学", "StudyMode": "全日制", "ExamMethod": "单考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：1(不含推免)", "Remark": "本专业方向招收援藏计划考生，援藏计划考生试题均与统考考生试题相同，具体招生数和复试分数线根据当年国家计划和生源质量综合确定，招生数以最终录取为准。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "202", "Name": "俄语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010101", "MajorName": "马克思主义哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "西方马克思主义", "StudyMode": "全日制", "ExamMethod": "单考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：1(不含推免)", "Remark": "本专业方向招收援藏计划考生，援藏计划考生试题均与统考考生试题相同，具体招生数和复试分数线根据当年国家计划和生源质量综合确定，招生数以最终录取为准。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "202", "Name": "俄语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010101", "MajorName": "马克思主义哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "马克思主义哲学原理", "StudyMode": "全日制", "ExamMethod": "单考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：1(不含推免)", "Remark": "本专业方向招收援藏计划考生，援藏计划考生试题均与统考考生试题相同，具体招生数和复试分数线根据当年国家计划和生源质量综合确定，招生数以最终录取为准。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "202", "Name": "俄语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010101", "MajorName": "马克思主义哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "马克思主义哲学史", "StudyMode": "全日制", "ExamMethod": "单考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：1(不含推免)", "Remark": "本专业方向招收援藏计划考生，援藏计划考生试题均与统考考生试题相同，具体招生数和复试分数线根据当年国家计划和生源质量综合确定，招生数以最终录取为准。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "202", "Name": "俄语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "835", "Name": "马克思主义哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010102", "MajorName": "中国哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "中国哲学史", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目③“哲学综合”考察中国哲学和西方哲学基础知识。 考试科目④“中国哲学”包括古代部分和现代部分。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "824", "Name": "中国哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "824", "Name": "中国哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010102", "MajorName": "中国哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "中国现代哲学", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目③“哲学综合”考察中国哲学和西方哲学基础知识。 考试科目④“中国哲学”包括古代部分和现代部分。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "824", "Name": "中国哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "824", "Name": "中国哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010103", "MajorName": "外国哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "东西方哲学与宗教比较", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目③“哲学综合”考察中国哲学和西方哲学基础知识。 考试科目④“西方哲学”包括西方哲学史和现代西方哲学。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "253", "Name": "法语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010103", "MajorName": "外国哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "现代西方哲学", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目③“哲学综合”考察中国哲学和西方哲学基础知识。 考试科目④“西方哲学”包括西方哲学史和现代西方哲学。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "253", "Name": "法语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010103", "MajorName": "外国哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "西方哲学史", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目③“哲学综合”考察中国哲学和西方哲学基础知识。 考试科目④“西方哲学”包括西方哲学史和现代西方哲学。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "253", "Name": "法语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "613", "Name": "哲学综合", "Description": "见招生简章" }, "Subject4": { "Code": "817", "Name": "西方哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" }, { "Year": 2026, "SchoolUUID": "19c934df19ce1a96e0f7dc295b8dbce0", "SchoolCode": "10001", "SchoolName": "北京大学", "Province": "北京", "City": "北京市", "CoverImage": "https://static.gugudata.com/f6099924acec11eb926b001a7dda7111.jpg", "IsDoubleFirstClass": true, "HasGraduateSchool": true, "IsSelfMarking": true, "DepartmentName": "哲学系", "MajorCode": "010108", "MajorName": "科学技术哲学", "DegreeType": "学术学位", "DisciplineCategoryCode": "01", "DisciplineCategoryName": "哲学", "FirstLevelDisciplineCode": "0101", "FirstLevelDisciplineName": "哲学", "DirectionName": "科学哲学与技术哲学", "StudyMode": "全日制", "ExamMethod": "统考", "Advisor": "不区分导师", "PlannedEnrollmentText": "专业：2(不含推免)", "Remark": "考试科目④“科学史与科学哲学”着重考察西方近现代科学史和科学哲学基础知识。", "ExamSubjectGroups": [ { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "201", "Name": "英语（一）", "Description": "见招生简章" }, "Subject3": { "Code": "303", "Name": "数学（三）", "Description": "见招生简章" }, "Subject4": { "Code": "820", "Name": "科学史与科学哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "202", "Name": "俄语", "Description": "见招生简章" }, "Subject3": { "Code": "303", "Name": "数学（三）", "Description": "见招生简章" }, "Subject4": { "Code": "820", "Name": "科学史与科学哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "203", "Name": "日语", "Description": "见招生简章" }, "Subject3": { "Code": "303", "Name": "数学（三）", "Description": "见招生简章" }, "Subject4": { "Code": "820", "Name": "科学史与科学哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "253", "Name": "法语", "Description": "见招生简章" }, "Subject3": { "Code": "303", "Name": "数学（三）", "Description": "见招生简章" }, "Subject4": { "Code": "820", "Name": "科学史与科学哲学", "Description": "见招生简章" } }, { "Subject1": { "Code": "101", "Name": "思想政治理论", "Description": "见招生简章" }, "Subject2": { "Code": "254", "Name": "德语", "Description": "见招生简章" }, "Subject3": { "Code": "303", "Name": "数学（三）", "Description": "见招生简章" }, "Subject4": { "Code": "820", "Name": "科学史与科学哲学", "Description": "见招生简章" } } ], "BrochureTitle": "", "BrochurePublishedDate": "", "BrochureSummary": "" } ] } } } }, "400": { "description": "参数或凭证冲突", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 501 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "401": { "description": "APPKEY 缺失或无效", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 504 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "403": { "description": "订单到期 / 额度耗尽", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 503, 505 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "429": { "description": "请求频率受限", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 502 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "500": { "description": "内部错误", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 900 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } }, "503": { "description": "招生目录服务暂不可用", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "正式请求仅返回年份、筛选长度及分页摘要；固定 Demo 展示完整示例条件。" }, "StatusCode": { "type": "integer", "enum": [ 901 ] }, "StatusDescription": { "type": "string" }, "ResponseDateTime": { "type": "string" }, "DataTotalCount": { "type": "integer", "minimum": 0, "description": "筛选后的全部匹配数量；失败为 0。" } }, "required": [ "RequestParameter", "StatusCode", "StatusDescription", "ResponseDateTime", "DataTotalCount" ], "additionalProperties": false }, "Data": { "type": "null" } }, "required": [ "DataStatus", "Data" ], "additionalProperties": false } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/postgraduate-program/demo" }, "parameters": [ { "name": "year", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 2147483647, "default": 2026 }, "description": "招生年份，默认 2026；正 Int32 整数。其他合法年份无数据时返回空数组，空值及非法值返回 501。" }, { "name": "schooluuid", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "" }, "description": "关联高校 ID 精确匹配，未关联的记录不推断补写；默认不筛选。" }, { "name": "schoolcode", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "" }, "description": "招生单位代码精确匹配；作为字符串传入，保留前导零；默认不筛选。", "example": "10001" }, { "name": "schoolname", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 100, "default": "" }, "description": "招生单位名称关键词；默认不筛选。" }, { "name": "province", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 32, "default": "" }, "description": "招生单位所在省份关键词；默认不筛选。" }, { "name": "majorcode", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "" }, "description": "专业代码精确匹配，例如 010101；作为字符串传入，保留前导零；默认不筛选。", "example": "010101" }, { "name": "majorname", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 100, "default": "" }, "description": "专业名称关键词；默认不筛选。" }, { "name": "degreeType", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "", "enum": [ "", "academic", "xs", "学术", "学术学位", "professional", "zyxw", "专业", "专业学位" ] }, "description": "学位类型，支持所列中英文别名，英文不区分大小写；空值或未传不筛选。" }, { "name": "studyMode", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 64, "default": "", "enum": [ "", "full_time", "full-time", "fulltime", "1", "全日制", "part_time", "part-time", "parttime", "2", "非全日制" ] }, "description": "学习方式，支持所列中英文别名，英文不区分大小写；空值或未传不筛选。" }, { "name": "isDoubleFirstClass", "in": "query", "required": false, "schema": { "type": "boolean", "enum": [ true, false ] }, "description": "双一流条件；支持 true/false、1/0、yes/no、是/否。空值或未传不筛选，不默认为 false。" }, { "name": "isSelfMarking", "in": "query", "required": false, "schema": { "type": "boolean", "enum": [ true, false ] }, "description": "自主划线条件；支持 true/false、1/0、yes/no、是/否。空值或未传不筛选，不默认为 false。" }, { "name": "pageindex", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 2147483647, "default": 1 }, "description": "页码从 1 开始，超出结果范围返回空数组及完整匹配总数。" }, { "name": "pagesize", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 }, "description": "每页 1～20 条，默认 10。" } ], "x-apifox-folder": "教育\\/高考", "security": [ { "AppKeyQuery": [] }, { "AppKeyHeader": [] }, { "AppKeyLegacyHeader": [] }, { "XApiKeyHeader": [] }, { "AppKeyBearer": [] } ] } }, "/metadata/vocational-control-lines": { "get": { "summary": "职教高考及高职分类招生控制线", "description": "查询职教高考及高职分类招生控制线\n接口标签：基础数据、职教高考、控制线数据\n接口特性：\n- 支持 2021 年至 2026 年多年份控制线数据查询\n- 支持按省份、招生类别、考生类型、录取批次、科类等多维条件筛选\n- 覆盖职教高考及高职分类招生相关控制线数据\n- 提供 /metadata/vocational-control-lines/enums 枚举辅助接口\n- 围绕“职教高考及高职分类招生控制线”提供标准化能力，便于快速接入现有业务\n- 适合将“职教高考及高职分类招生控制线”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/vocationalcontrollines", "operationId": "get_vocationalcontrollines", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/vocationalcontrollines" }, "x-gugudata-api-identity": "vocationalcontrollines", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "可通过判断此状态码断言接口正常返回。" }, { "code": "501", "title": "参数错误", "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。" }, { "code": "502", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 10 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "503", "title": "APPKEY 权限超限或订单到期", "remark": "请前往开发者中心检查 APPKEY 状态与订单有效期。" }, { "code": "504", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否正确。" }, { "code": "505", "title": "请求次数超出接口限制", "remark": "请检查接口剩余请求次数与配额限制。" }, { "code": "900", "title": "接口内部响应错误", "remark": "接口服务暂时不可用，请稍后重试。" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "DataId": { "type": "string", "description": "数据全局唯一 ID" }, "Year": { "type": "integer", "format": "int32", "description": "年份" }, "Province": { "type": "string", "description": "省份名称" }, "Category": { "type": "string", "description": "招生类别名称" }, "StudentType": { "type": "string", "description": "考生类型" }, "ScoreBatch": { "type": "string", "description": "录取批次" }, "SubjectCategory": { "type": "string", "description": "科类名称" }, "Score": { "type": "integer", "format": "int32", "description": "控制线分数，没有值时返回 null" }, "Remark": { "type": "string", "description": "备注说明，没有值时返回空字符串" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/metadata/vocational-control-lines/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "查询年份。当前可选值：2021、2022、2023、2024、2025、2026。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "integer", "format": "int32" }, "example": 2025 }, { "name": "provinceName", "in": "query", "required": false, "description": "招生省份名称。当前可选值：上海、云南、内蒙古、北京、吉林、四川、天津、宁夏、安徽、山东、山西、广东、广西、江苏、河北、河南、浙江、海南、湖北、湖南、甘肃、福建、重庆、陕西、黑龙江。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "categoryCode", "in": "query", "required": false, "description": "招生类别编码，为空时不按类别编码筛选。当前可选值：75001、75002、75003、75004、75005、75009、75010、75011、75012、75013、75014、75015、75016、75018、75019、75021、75022。不同年份、省份下的数据覆盖可能不同。", "schema": { "type": "string" } }, { "name": "category", "in": "query", "required": false, "description": "招生类别筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举（https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related）（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.category。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, { "name": "studentType", "in": "query", "required": false, "description": "考生类型筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举（https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related）（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.studentType。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, { "name": "scoreBatch", "in": "query", "required": false, "description": "录取批次筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举（https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related）（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.scoreBatch。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, { "name": "subjectCategory", "in": "query", "required": false, "description": "科类筛选。可选值请通过 职教高考及高职分类招生控制线-查询参数枚举（https://www.gugudata.com/api/details/vocationalcontrollines#anchor_related）（/metadata/vocational-control-lines/enums）获取，使用返回字段 Data.subjectCategory。请按查询年份 year 和招生省份 provinceName 获取适用取值。", "schema": { "type": "string", "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, "x-gugudata-enum-source": "https://api.gugudata.com/metadata/vocational-control-lines/enums" }, { "name": "pageIndex", "in": "query", "required": false, "description": "分页参数，第几页，默认值为 1", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pageSize", "in": "query", "required": false, "description": "分页参数，每页条数，取值范围在 1 ~ 100 之间（含）", "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "x-apifox-folder": "教育\\/高考" } }, "/metadata/vocational-control-lines/enums": { "get": { "summary": "职教高考及高职分类招生控制线-查询参数枚举", "description": "返回 category、studentType、scoreBatch、subjectCategory 的枚举集合。\n接口标签：基础数据、职教高考、控制线数据\n详情页：https://www.gugudata.com/api/details/vocationalcontrollines", "operationId": "get_get_metadata_vocational_control_lines_enums", "tags": [ "教育/高考" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/vocationalcontrollines" }, "x-gugudata-api-identity": "vocationalcontrollines", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "可通过判断此状态码断言接口正常返回。" }, { "code": "501", "title": "参数错误", "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。" }, { "code": "502", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 10 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "503", "title": "APPKEY 权限超限或订单到期", "remark": "请前往开发者中心检查 APPKEY 状态与订单有效期。" }, { "code": "504", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否正确。" }, { "code": "505", "title": "请求次数超出接口限制", "remark": "请检查接口剩余请求次数与配额限制。" }, { "code": "900", "title": "接口内部响应错误", "remark": "接口服务暂时不可用，请稍后重试。" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "咕咕数据业务状态码，100 表示业务处理成功。" }, "StatusDescription": { "type": "string", "description": "业务状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口响应时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "本次响应数据总数或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "category": { "type": "array", "items": { "type": "string" } }, "studentType": { "type": "array", "items": { "type": "string" } }, "scoreBatch": { "type": "array", "items": { "type": "string" } }, "subjectCategory": { "type": "array", "items": { "type": "string" } } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-operation-kind": "related", "x-gugudata-parent-api-identity": "vocationalcontrollines", "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/vocationalcontrollines", "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "year", "in": "query", "required": true, "description": "年份，如 2025。", "schema": { "type": "integer", "format": "int32" }, "example": 0 }, { "name": "provinceName", "in": "query", "required": true, "description": "省份名称，如 江苏、江苏省。", "schema": { "type": "string" } } ], "x-apifox-folder": "教育\\/高考" } }, "/news/fetchcontent": { "post": { "summary": "获取任意链接文章正文", "description": "根据文章链接提取标题、正文和发布时间。\n详情页：https://www.gugudata.com/api/details/fetchcontent", "operationId": "post_fetchcontent", "tags": [ "元数据/资讯" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fetchcontent" }, "x-gugudata-api-identity": "fetchcontent", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，此接口返回 1" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Url": { "type": "string", "description": "文章 Url" }, "Title": { "type": "string", "description": "文章标题" }, "Content": { "type": "string", "description": "智能分析出的文章正文。contentwithhtml=false 或省略时为不含 HTML 标签的纯文本；contentwithhtml=true 时为带 HTML 标签的正文" }, "HTMLSourceContent": { "type": "string", "description": "文章的原始 HTML 内容（HTML 标签为 Unicode 编码）" }, "PublishDate": { "type": "string", "description": "文章发表时间" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "数据服务暂时不可用，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/news/fetchcontent/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "需要抓取正文的文章链接" }, "contentwithhtml": { "type": "boolean", "description": "是否返回带 HTML 标签的正文；省略或 false 时 Content 为纯文本", "default": false }, "htmlsourcecontent": { "type": "boolean", "description": "是否返回文章页面原始 HTML 内容，供您二次解析使用；开启后响应体会增大", "default": false } }, "required": [ "url" ] }, "example": { "url": "YOUR_VALUE", "contentwithhtml": false, "htmlsourcecontent": false } } } }, "x-apifox-folder": "元数据\\/资讯" } }, "/news/fetchcontentimages": { "post": { "summary": "获取任意链接正文图片", "description": "智能分析链接正文中的图片集合\n接口标签：网络工具、文本处理、解析任意链接、支持图片大小筛选\n接口特性：\n- 根据提供的文章链接智能分析出文章正文中包含的图片列表\n- 支持传递图片大小以及图片分辨率条件对返回图片列表进行筛选\n- 接口可同时返回原始 HTML 内容，供您二次解析使用\n- 图片解析与标签处理基于机器学习\n- 围绕“获取任意链接正文图片”提供标准化能力，便于快速接入现有业务\n- 适合将“获取任意链接正文图片”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/fetchcontentimages", "operationId": "post_fetchcontentimages", "tags": [ "元数据/资讯" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/fetchcontentimages" }, "x-gugudata-api-identity": "fetchcontentimages", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "符合条件的图片集合数量" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Url": { "type": "string", "description": "文章 Url" }, "ImagesUrl": { "type": "array", "items": { "type": "string" }, "description": "文章正文中符合筛选条件的图片 Url 集合" }, "ImagesTag": { "type": "array", "items": { "type": "string" }, "description": "当传递 imagewithtag 参数值为 true 时，返回获取到的图片原始 img HTML 标签" }, "HTMLSourceContent": { "type": "string", "description": "文章的原始 HTML 内容（HTML 标签为 Unicode 编码）" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/news/fetchcontentimages/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" } ], "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "需要抓取正文的文章链接" }, "limittype": { "type": "string", "description": "对图片大小进行筛选条件类型，参数值为 size 或 ratio。size：按照图片大小 (KB) 进行筛选，ratio：按照图片分辨率 [宽,高] 进行筛选" }, "limitvalue": { "type": "string", "description": "对图片大小进行筛选条件值，如果类型为 size，参数值格式为 float 类型的图片最小限制值（单位为 KB），如果类型为 ratio，参数值格式为 int 数组 [宽,高]，分别限制最小宽与高（单位为像素）" }, "imagewithtag": { "type": "boolean", "description": "是否返回获取到的图片原始 img HTML 标签" }, "htmlsourcecontent": { "type": "boolean", "description": "是否返回文章页面原始 HTML 内容，供您二次解析或分析正文图片列表失败时使用，需要注意接口的性能问题" } }, "required": [ "url" ] }, "example": { "url": "YOUR_VALUE", "limittype": "YOUR_VALUE", "limitvalue": "YOUR_VALUE", "imagewithtag": false, "htmlsourcecontent": false } } } }, "x-apifox-folder": "元数据\\/资讯" } }, "/news/joke": { "get": { "summary": "幽默笑话大全", "description": "提供全网最全的幽默笑话数据\n接口标签：基础数据、支持按类别获取、聚合数据\n接口特性：\n- 提供全网最全的幽默笑话数据\n- 已有近 4 万条数据，并周期性新增数据\n- 支持 35 种笑话分类检索查询\n- 围绕“幽默笑话大全”提供标准化能力，便于快速接入现有业务\n- 适合将“幽默笑话大全”结果接入业务系统、后台工具和自动化流程\n- 适合娱乐内容、社区互动和轻量内容推荐场景\n- 支持将笑话内容接入小程序、机器人和运营活动\n- 便于按主题、长度和使用场景组织娱乐内容\n详情页：https://www.gugudata.com/api/details/joke", "operationId": "get_joke", "tags": [ "元数据/资讯" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/joke" }, "x-gugudata-api-identity": "joke", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "Id": { "type": "string", "description": "笑话唯一 ID" }, "Type": { "type": "string", "description": "笑话分类" }, "Title": { "type": "string", "description": "笑话标题" }, "Content": { "type": "string", "description": "笑话内容" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/news/joke/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "type", "in": "query", "required": true, "description": "笑话分类，支持类型：'所有','经典','名著暴笑','爆笑男女','哈哈趣闻','原创','恐怖','爱情','校园','幽默','儿童','爆笑','综合','动物','顺口溜','搞笑歌词','恋爱必读','英语','短信','求爱秘籍','极品','数学','一句话','短笑话','小笑话','内涵','冷笑话','重口味','整人','各地方言','短篇','搞笑','简短','超级','数码'", "schema": { "type": "string", "enum": [ "所有", "经典", "名著暴笑", "爆笑男女", "哈哈趣闻", "原创", "恐怖", "爱情", "校园", "幽默", "儿童", "爆笑", "综合", "动物", "顺口溜", "搞笑歌词", "恋爱必读", "英语", "短信", "求爱秘籍", "极品", "数学", "一句话", "短笑话", "小笑话", "内涵", "冷笑话", "重口味", "整人", "各地方言", "短篇", "搞笑", "简短", "超级", "数码" ] }, "example": "YOUR_VALUE" }, { "name": "pageindex", "in": "query", "required": false, "description": "页码", "schema": { "type": "integer", "format": "int32" }, "example": 1 }, { "name": "pagesize", "in": "query", "required": false, "description": "每页数据量，参数最大值为 100", "schema": { "type": "integer", "format": "int32" }, "example": 10 } ], "x-apifox-folder": "元数据\\/资讯" } }, "/news/wxarticlecover": { "get": { "summary": "获取公众号文章封面", "description": "根据微信公众号文章链接获取文章封面图地址\n接口标签：网络工具、文本处理、解析任意文章、返回官方地址\n接口特性：\n- 支持从微信公众号文章链接中提取封面图地址\n- url 需传入完整的 mp.weixin.qq.com 文章链接\n- 返回 CoverUrl，可用于文章列表封面展示、内容归档和素材管理\n- 提取结果受文章状态、访问权限和微信页面结构变化影响\n- 围绕“获取公众号文章封面”提供标准化能力，便于快速接入现有业务\n- 适合将“获取公众号文章封面”结果接入业务系统、后台工具和自动化流程\n- 适合资讯聚合、内容归档和运营素材整理场景\n- 支持将文章、图片或封面结果接入内容管理系统\n详情页：https://www.gugudata.com/api/details/wxarticlecover", "operationId": "get_wxarticlecover", "tags": [ "元数据/资讯" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/wxarticlecover" }, "x-gugudata-api-identity": "wxarticlecover", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "RequestParameter": { "type": "string", "description": "本次请求的参数摘要字符串。" }, "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码。" }, "Status": { "type": "string", "description": "接口返回状态，例如 SUCCESS 或 ERROR。" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明。" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间。" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的数据总量；对象型结果通常为 1，列表型结果为列表数量或分页总数。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "CoverUrl": { "type": "string", "description": "微信公众号文章封面图 URL。" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/news/wxarticlecover/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "url", "in": "query", "required": true, "description": "微信公众号文章 URL，需要传入完整链接。", "schema": { "type": "string" }, "example": "https://mp.weixin.qq.com/s/xxxx" } ], "x-apifox-folder": "元数据\\/资讯" } }, "/sms/internationalphone": { "get": { "summary": "国际手机号码检查纠正", "description": "格式有效性检查及智能纠正\n接口标签：网络工具、遵循 E.164 标准、智能统一格式\n接口特性：\n- 智能检测国际手机号码格式有效性\n- 可根据提供的国家编码参数，判断提供的手机号码是否为该国家有效手机号码\n- 智能纠正提供的手机号码格式为统一的国际编码格式，供后续如发送短信等场景统一使用\n- 毫秒级响应性能\n- 围绕“国际手机号码检查纠正”提供标准化能力，便于快速接入现有业务\n- 适合将“国际手机号码检查纠正”结果接入业务系统、后台工具和自动化流程\n- 适合注册登录、客户资料清洗和号码质量校验场景\n- 可与手机号归属地和国际号码校验接口组合使用\n详情页：https://www.gugudata.com/api/details/internationalphone", "operationId": "get_internationalphone", "tags": [ "网站工具" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/internationalphone" }, "x-gugudata-api-identity": "internationalphone", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "IsValid": { "type": "boolean", "description": "手机号码是否有效，如提供了 countrycode 参数，此参数表示号码是否在指定国家有效" }, "SourceMobileNumber": { "type": "string", "description": "请求的原始手机号码" }, "CorrectedMobileNumber": { "type": "string", "description": "纠正后的手机号码" }, "CountryCode": { "type": "string", "description": "国家电话前缀，如 +1" }, "CountryCode2": { "type": "string", "description": "ISO-3166 标准两位国家代码" }, "CountryCode3": { "type": "string", "description": "ISO-3166 标准三位国家代码" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/sms/internationalphone/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "phone", "in": "query", "required": true, "description": "查询的手机号码，如 +1(817) 569-8900", "schema": { "type": "string" }, "example": "PHONE" }, { "name": "countrycode", "in": "query", "required": false, "description": "ISO-3166 标准的两位或三位国家代码，用于校验号码在提供的归属国家是否为有效号码，如 US, USA，不传递则智能纠错", "schema": { "type": "string" }, "example": "COUNTRY_CODE" } ], "x-apifox-folder": "网站工具" } }, "/sms/mobileattribution": { "get": { "summary": "手机归属地查询", "description": "精确查询手机号码的归属地\n接口标签：基础数据、网络工具、支持 HTTPS、300万数据精准支撑\n接口特性：\n- 提供精确、高效的手机归属地查询，支持用户标记的返回\n- 每周定时更新全网最全的数据集\n- 超高查询性能，毫秒级返回\n- 围绕“手机归属地查询”提供标准化能力，便于快速接入现有业务\n- 适合将“手机归属地查询”结果接入业务系统、后台工具和自动化流程\n- 适合注册登录、客户资料清洗和号码质量校验场景\n- 可与手机号归属地和国际号码校验接口组合使用\n- 支持对用户输入号码进行格式检查和地域补全\n详情页：https://www.gugudata.com/api/details/mobileattribution", "operationId": "get_mobileattribution", "tags": [ "网站工具" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/mobileattribution" }, "x-gugudata-api-identity": "mobileattribution", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "MobileNumber": { "type": "string", "description": "查询的手机号码" }, "Province": { "type": "string", "description": "手机号码所在的省份" }, "City": { "type": "string", "description": "手机号码所在的市" }, "Operator": { "type": "string", "description": "手机运营商" }, "AreaCode": { "type": "string", "description": "手机所在地区号" }, "ZipCode": { "type": "string", "description": "手机所在地邮编" }, "UserTag": { "type": "string", "description": "用户对此电话号码的标记，仅供参考" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/sms/mobileattribution/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "mobile", "in": "query", "required": true, "description": "查询的手机号码", "schema": { "type": "string" }, "example": "YOUR_VALUE" } ], "x-apifox-folder": "网站工具" } }, "/stock/cn": { "get": { "summary": "A 股历史行情数据", "description": "历史数据支持日线/周线/月线\n接口标签：股票、A股、历史数据、全量历史交易、包含前后复权数据\n接口特性：\n- 支持 A 股历史日线、周线、月线数据查询\n- 包含上交所和深交所所有股票数据\n- 每日 A 股收盘后更新当日交易数据，停牌不更新\n- 支持一次查询多个股票历史数据\n- 支持最大 3660 个自然日时间窗口查询\n- 超高查询效率，千万级数据毫秒级返回\n- 支持未复权、前复权、后复权三种数据形态查询\n- 围绕“A 股历史行情数据”提供标准化能力，便于快速接入现有业务\n详情页：https://www.gugudata.com/api/details/stockcn", "operationId": "get_stockcn", "tags": [ "金融/基础" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/stockcn" }, "x-gugudata-api-identity": "stockcn", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "TimeKey": { "type": "integer", "format": "int32", "description": "交易日期" }, "Symbol": { "type": "string", "description": "A股股票代码" }, "StockName": { "type": "string", "description": "股票名称" }, "Open": { "type": "number", "description": "开盘价，单位：元" }, "Close": { "type": "number", "description": "收盘价，单位：元" }, "High": { "type": "number", "description": "最高，单位：元" }, "Low": { "type": "number", "description": "最低，单位：元" }, "TradingVolume": { "type": "integer", "format": "int32", "description": "成交量，单位：股" }, "TradingAmount": { "type": "number", "description": "成交额，单位：元" }, "Swing": { "type": "number", "description": "振幅，单位：%" }, "ChangePercent": { "type": "number", "description": "涨跌幅，单位：%" }, "ChangeAmount": { "type": "number", "description": "涨跌额，单位：元" }, "TurnoverRate": { "type": "number", "description": "换手率，单位：%" } }, "description": "接口返回的业务数据。" } }, "description": "咕咕数据标准响应结构。" } } } }, "400": { "description": "请求参数错误。请求参数缺失、格式错误或参数组合不合法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "401": { "description": "鉴权失败。缺少 appkey 或 appkey 无效。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "403": { "description": "无权限访问。订单到期、权限不足或接口额度不可用。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "404": { "description": "资源不存在。请求路径不存在。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "405": { "description": "请求方法不允许。当前路径不支持该 HTTP 方法。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "415": { "description": "请求内容类型不支持。上传或请求体的内容类型不符合接口要求。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "429": { "description": "请求频率受限。默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "500": { "description": "服务内部错误。服务端处理异常，请稍后重试。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } }, "502": { "description": "上游依赖错误。上游依赖服务不可用或返回异常。", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CommonResponse" } } } } }, "x-gugudata-demo": { "method": "GET", "url": "https://api.gugudata.com/stock/cn/demo" }, "parameters": [ { "name": "appkey", "in": "query", "required": true, "description": "咕咕数据开发者中心分配的 APPKEY。", "schema": { "type": "string" }, "example": "{{appkey}}" }, { "name": "symbol", "in": "query", "required": true, "description": "A股股票代码，具体值参见 A股股票代码参数枚举页面。支持一次查询多个股票，使用逗号分隔（兼容中文逗号，会自动规范化）；每次最多 10 个。单个代码支持 600031 或 sh600031/sz000001/bj430047，带交易所前缀时会自动规范化为 6 位代码。", "schema": { "type": "string", "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcn/symbols" }, "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcn/symbols", "example": "YOUR_VALUE" }, { "name": "begindate", "in": "query", "required": true, "description": "股票交易开始时间，格式为 20200101，且不能晚于 enddate。", "schema": { "type": "string" }, "example": "YOUR_VALUE" }, { "name": "enddate", "in": "query", "required": true, "description": "股票交易结束时间，格式为 20200101，与 begindate 最大时间跨度为 3660 个自然日。获取更长区间请分批请求，并保持合理请求频率。", "schema": { "type": "string" }, "example": "YOUR_VALUE" }, { "name": "adjust", "in": "query", "required": false, "description": "复权类型，默认空（不复权）。可选值：pre（前复权）、after（后复权）；传入其他值将返回参数错误。", "schema": { "type": "string", "enum": [ "pre", "after" ] } }, { "name": "period", "in": "query", "required": false, "description": "数据周期，默认 daily。可选值：daily（日线）、weekly（周线）、monthly（月线）；传入其他值将返回参数错误。", "schema": { "type": "string", "enum": [ "daily", "weekly", "monthly" ] }, "example": "daily" } ], "x-apifox-folder": "金融\\/基础" } }, "/stock/cn/annualreport": { "get": { "summary": "A 股历年三大财务报表", "description": "历年所有财报数据\n接口标签：股票、A股、全量A股数据、最全三大财报数据\n接口特性：\n- 支持所有 A 股全量三大财报数据查询\n- 分别包括资产负债表、利润表、现金流量表数据\n- 返回 70 多项财务指标\n- 多数据源清洗整合，百万级数据毫秒级返回\n- 围绕“A 股历年三大财务报表”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股历年三大财务报表”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/cnannualreport", "operationId": "get_cnannualreport", "tags": [ "金融/基础" ], "externalDocs": { "description": "API detail page", "url": "https://www.gugudata.com/api/details/cnannualreport" }, "x-gugudata-api-identity": "cnannualreport", "x-gugudata-business-status-codes": [ { "code": "100", "title": "正常返回", "remark": "" }, { "code": "101", "title": "参数错误", "remark": "" }, { "code": "102", "title": "请求频率受限", "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。" }, { "code": "103", "title": "账号欠费", "remark": "" }, { "code": "104", "title": "APPKEY 错误", "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值" }, { "code": "110", "title": "接口响应错误", "remark": "" } ], "responses": { "200": { "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。", "content": { "application/json": { "schema": { "type": "object", "properties": { "DataStatus": { "type": "object", "properties": { "StatusCode": { "type": "integer", "format": "int32", "description": "接口返回状态码" }, "StatusDescription": { "type": "string", "description": "接口返回状态说明" }, "ResponseDateTime": { "type": "string", "description": "接口数据返回时间" }, "DataTotalCount": { "type": "integer", "format": "int32", "description": "此条件下的总数据量，一般用于分页计算" }, "RequestParameter": { "description": "本次请求的参数摘要。" } }, "description": "接口业务状态信息。" }, "Data": { "type": "object", "properties": { "columns": { "type": "array", "items": { "type": "string" }, "description": "财报的数据列名称，注意因为财报数据字段非常多且为了保证表达精准性，这里的字段说明以中文进行表达。" }, "data": { "type": "array", "items": { "type": "object", "properties": { "资产负债表": { "type": "array", "items": { "type": "string" }, "description": "资产负债表.报表日期