{
  "openapi": "3.1.0",
  "info": {
    "title": "GuGuData API",
    "version": "3.1",
    "description": "咕咕数据公开 API 的标准 OpenAPI 3.1 规范，覆盖官网当前可见的数据服务接口。可用于接口检索、参数查看、在线调试和客户端代码生成。",
    "x-gugudata-counts": {
      "base": 140,
      "pre": 9,
      "related": 23,
      "total": 172
    }
  },
  "servers": [
    {
      "url": "https://api.gugudata.com",
      "description": "Production API"
    }
  ],
  "tags": [
    {
      "name": "AI/模型接口",
      "description": "AI 对话、模型分析和智能处理接口。"
    },
    {
      "name": "条码与二维码接口",
      "description": "条码、二维码和码制生成识别接口。"
    },
    {
      "name": "金融与行情接口",
      "description": "金融基础数据、汇率和行情数据接口。"
    },
    {
      "name": "图像与文档转换接口",
      "description": "图像识别、OCR 和文档转换接口。"
    },
    {
      "name": "区域坐标与定位接口",
      "description": "行政区划、地理位置和坐标定位接口。"
    },
    {
      "name": "元数据与教育接口",
      "description": "公共基础数据、教育和高校数据接口。"
    },
    {
      "name": "汽车车型接口",
      "description": "汽车品牌、车系和车型数据接口。"
    },
    {
      "name": "资讯与内容接口",
      "description": "新闻资讯、公众号文章和内容抓取接口。"
    },
    {
      "name": "搜索可见性接口",
      "description": "关键词排名可见性、覆盖率和竞品对比接口。"
    },
    {
      "name": "股票证券接口",
      "description": "A 股、美股、港股和基金证券数据接口。"
    },
    {
      "name": "文本与 NLP 接口",
      "description": "文本处理、语言识别和自然语言处理接口。"
    },
    {
      "name": "天气与节气接口",
      "description": "天气预报、空气质量和节气日历接口。"
    },
    {
      "name": "网站工具接口",
      "description": "网页抓取、链接提取和站点处理接口。"
    },
    {
      "name": "国学与命理接口",
      "description": "传统历法、生肖、星座和命理文化参考接口。"
    }
  ],
  "paths": {
    "/Weather/AirQuality": {
      "get": {
        "summary": "全国城市实时空气质量指数",
        "description": "城市空气质量实时查询\n接口标签：基础数据、极速响应数据、城市空气质量数据\n接口特性：\n- 支持按中国城市名称查询实时空气质量数据\n- 返回 AQI、空气质量等级、PM2.5 浓度和首要污染物\n- 围绕“全国城市实时空气质量指数”提供标准化能力，便于快速接入现有业务\n- 适合将“全国城市实时空气质量指数”结果接入业务系统、后台工具和自动化流程\n- 适合出行服务、城市看板和生活服务页面接入\n- 可与天气、空气质量、日出日落和农历接口组合展示\n- 支持按城市、日期或时间维度组织环境信息\n- 支持按 AQI 等级、PM2.5 指标和首要污染物组织提醒规则\n详情页：https://www.gugudata.com/api/details/airquality",
        "operationId": "get_airquality",
        "tags": [
          "天气与节气接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/airquality"
        },
        "x-gugudata-api-identity": "airquality",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每分钟请求不能超过 100 次"
          },
          {
            "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": "省份名称"
                        },
                        "City": {
                          "type": "string",
                          "description": "城市名称"
                        },
                        "AQI": {
                          "type": "string",
                          "description": "空气质量指数"
                        },
                        "Quality": {
                          "type": "string",
                          "description": "空气质量"
                        },
                        "PM25": {
                          "type": "string",
                          "description": "PM2.5 浓度"
                        },
                        "PrimaryPollutant": {
                          "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/Weather/AirQuality/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "city",
            "in": "query",
            "required": true,
            "description": "需要查询的中国城市名称，例如：北京、南京、上海、广州、深圳。接口会按城市名称实时匹配当前可用监测数据，不再限制为旧版固定城市列表。",
            "schema": {
              "type": "string"
            },
            "example": "北京"
          }
        ]
      }
    },
    "/ai/admission/major-line-rank": {
      "post": {
        "summary": "专业录取线按录取概率排序",
        "description": "先查询历年高考专业录取分数线候选集，再结合录取概率预测结果排序返回，适合按省份、科类和分数筛选专业线后做志愿梯度参考\n接口标签：AI、高考、高考录取、高等教育、AI预测、高考志愿、录取概率\n详情页：https://www.gugudata.com/api/details/admission-predict",
        "operationId": "post_post_ai_admission_major_line_rank",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/admission-predict"
        },
        "x-gugudata-api-identity": "admission-predict",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "缺少 province、subject_type、score 或 appkey 等必填参数"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "请降低请求频率"
          },
          {
            "code": "503",
            "title": "APPKEY 过期或订单失效",
            "remark": "请前往开发者中心确认订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "505",
            "title": "超出调用次数",
            "remark": "当前 APPKEY 已达到订单调用上限"
          },
          {
            "code": "-9",
            "title": "预测失败或服务处理异常",
            "remark": "模型服务异常、数据源异常或内部处理失败时返回"
          }
        ],
        "responses": {
          "200": {
            "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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": "admission-predict",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/admission-predict",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "province": {
                    "type": "string",
                    "description": "考生所在省份，对应专业录取线的 enrollProvince"
                  },
                  "subject_type": {
                    "type": "string",
                    "description": "科类/选科，对应专业录取线的 typeName，例如 物理类、历史类、理科、文科、综合"
                  },
                  "score": {
                    "type": "number",
                    "description": "考生裸分（0-750），用于计算专业线候选项的录取概率"
                  },
                  "rank": {
                    "type": "integer",
                    "format": "int32",
                    "description": "考生全省位次，可为空"
                  },
                  "batch": {
                    "type": "string",
                    "description": "报考批次，默认 本科批，对应专业录取线的 batchName"
                  },
                  "year": {
                    "type": "integer",
                    "format": "int32",
                    "description": "预测年份，默认与 line_year 保持一致"
                  },
                  "line_year": {
                    "type": "integer",
                    "format": "int32",
                    "description": "专业录取线年份，默认使用 year"
                  },
                  "major_name": {
                    "type": "string",
                    "description": "专业名称过滤条件"
                  },
                  "school_name": {
                    "type": "string",
                    "description": "院校名称过滤条件"
                  },
                  "uuid": {
                    "type": "string",
                    "description": "院校唯一 ID，可用于限定单个院校"
                  },
                  "schooluuid": {
                    "type": "string",
                    "description": "院校唯一 ID，等同于 uuid"
                  },
                  "target_college_uuids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "院校唯一 ID 列表，可用于限定多个院校"
                  },
                  "subject_selection": {
                    "type": "string",
                    "description": "选科要求过滤条件，对应专业录取线的 subjectSelection"
                  },
                  "min_score": {
                    "type": "integer",
                    "format": "int32",
                    "description": "录取最低分小于等于该值的过滤条件"
                  },
                  "minrange": {
                    "type": "string",
                    "description": "录取最低分区间，格式如 500,700"
                  },
                  "score_window": {
                    "type": "integer",
                    "format": "int32",
                    "description": "省份宽查询时围绕考生成绩自动生成候选分数区间，默认 60，传 0 可关闭"
                  },
                  "sort": {
                    "type": "string",
                    "description": "专业线候选集原始排序条件"
                  },
                  "probability_sort": {
                    "type": "string",
                    "description": "录取概率排序方向，支持 desc 或 asc，默认 desc"
                  },
                  "page_index": {
                    "type": "integer",
                    "format": "int32",
                    "description": "排序后页码，从 1 开始，默认 1"
                  },
                  "page_size": {
                    "type": "integer",
                    "format": "int32",
                    "description": "排序后每页数量，默认 10，最大 50"
                  },
                  "candidate_limit": {
                    "type": "integer",
                    "format": "int32",
                    "description": "最多参与预测排序的专业线候选数量，默认 30，最大 50"
                  },
                  "major_name_strict": {
                    "type": "boolean",
                    "description": "专业名称是否严格匹配，默认 false"
                  },
                  "exclude_major_category": {
                    "type": "boolean",
                    "description": "是否过滤专业大类记录，默认 true"
                  },
                  "include_prediction_evidence": {
                    "type": "boolean",
                    "description": "是否返回模型证据字段，默认 false"
                  }
                },
                "required": [
                  "province",
                  "subject_type",
                  "score"
                ]
              },
              "example": {
                "province": "",
                "subject_type": "",
                "score": 0,
                "rank": 0,
                "batch": "",
                "year": 0,
                "line_year": 0,
                "major_name": "",
                "school_name": "",
                "uuid": "",
                "schooluuid": "",
                "target_college_uuids": [],
                "subject_selection": "",
                "min_score": 0,
                "minrange": "",
                "score_window": 0,
                "sort": "",
                "probability_sort": "",
                "page_index": 0,
                "page_size": 0,
                "candidate_limit": 0,
                "major_name_strict": false,
                "exclude_major_category": false,
                "include_prediction_evidence": false
              }
            }
          }
        }
      }
    },
    "/ai/admission/predict": {
      "post": {
        "summary": "基于模型的高校录取概率预测",
        "description": "高校录取概率预测\n详情页：https://www.gugudata.com/api/details/admission-predict",
        "operationId": "post_admission_predict",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/admission-predict"
        },
        "x-gugudata-api-identity": "admission-predict",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "缺少 province、subject_type、score 或 appkey 等必填参数"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "请降低请求频率"
          },
          {
            "code": "503",
            "title": "APPKEY 过期或订单失效",
            "remark": "请前往开发者中心确认订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "505",
            "title": "超出调用次数",
            "remark": "当前 APPKEY 已达到订单调用上限"
          },
          {
            "code": "-9",
            "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": "本次请求的参数摘要。",
                          "type": "string"
                        },
                        "RequestId": {
                          "type": "string"
                        },
                        "NoDataReason": {
                          "type": "string",
                          "description": "有效请求无结果时的 envelope 原因码。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "predictions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "college_name": {
                                "type": "string",
                                "description": "院校名称"
                              },
                              "admission_probability": {
                                "type": "number",
                                "minimum": 0,
                                "maximum": 1,
                                "description": "模型输出的录取参考概率，不构成录取承诺。"
                              },
                              "recommendation": {
                                "type": "string",
                                "description": "模型生成的录取参考建议文本。"
                              },
                              "long_recommendation": {
                                "type": "string",
                                "description": "面向用户的长句原因解释，结合近年录取线、分差、院校层次、专业匹配情况与补充策略生成"
                              },
                              "evidence": {
                                "type": "object",
                                "additionalProperties": true,
                                "description": "关键证据信息对象，可能包含近三年最低线、加权基线分差、省控线差、院校层次、院校排名、招生计划覆盖率、聚合模式等字段",
                                "properties": {
                                  "recent_3y_min_score": {
                                    "type": "array",
                                    "items": {
                                      "type": "number"
                                    }
                                  },
                                  "score_gap": {
                                    "type": "number"
                                  },
                                  "score_gap_original": {
                                    "type": "number"
                                  },
                                  "province_line_gap": {
                                    "type": "number"
                                  },
                                  "is_985": {
                                    "type": "boolean"
                                  },
                                  "is_211": {
                                    "type": "boolean"
                                  },
                                  "is_dual_class": {
                                    "type": "boolean"
                                  },
                                  "college_rank": {
                                    "type": "integer",
                                    "format": "int32"
                                  },
                                  "plan_enrollment": {
                                    "type": "integer",
                                    "format": "int32"
                                  },
                                  "plan_coverage_ratio": {
                                    "type": "number"
                                  },
                                  "major_hist_avg": {
                                    "type": "number"
                                  },
                                  "major_recent_min_trend": {
                                    "type": "number"
                                  },
                                  "aggregation_mode": {
                                    "type": "string"
                                  },
                                  "matched_plan_rows": {
                                    "type": "integer",
                                    "format": "int32"
                                  },
                                  "covered_plan_total": {
                                    "type": "integer",
                                    "format": "int32"
                                  },
                                  "school_plan_total": {
                                    "type": "integer",
                                    "format": "int32"
                                  }
                                }
                              },
                              "shap_explanation": {
                                "type": [
                                  "object",
                                  "null"
                                ],
                                "description": "SHAP 解释信息，含 base_probability、predicted_probability、top_features，仅在 include_explanation=true 时返回"
                              },
                              "major_name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "命中专业级预测时返回对应专业名称；若结果回退到院校层，则该字段可能为空"
                              },
                              "tier_name": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "命中的概率档位标识，仅在请求 probability_tiers 时返回"
                              },
                              "tier_label": {
                                "type": [
                                  "string",
                                  "null"
                                ],
                                "description": "命中的概率档位展示名称，仅在请求 probability_tiers 时返回"
                              },
                              "tier_min_probability": {
                                "type": [
                                  "number",
                                  "null"
                                ],
                                "minimum": 0,
                                "maximum": 1,
                                "description": "命中档位的录取概率下限，仅在请求 probability_tiers 时返回；下一档会自动以上一档下限作为概率上界"
                              }
                            }
                          },
                          "description": "院校及专业录取参考概率结果列表。"
                        },
                        "meta": {
                          "type": "object",
                          "properties": {
                            "total_colleges": {
                              "type": "integer",
                              "format": "int32",
                              "description": "返回院校数量"
                            },
                            "student_score": {
                              "type": "number",
                              "description": "考生分数"
                            },
                            "student_province": {
                              "type": "string",
                              "description": "考生省份"
                            },
                            "local_colleges": {
                              "type": [
                                "integer",
                                "null"
                              ],
                              "format": "int32",
                              "description": "结果中同省院校数量，无 is_local 字段时为 null"
                            },
                            "score_diff_min": {
                              "type": [
                                "number",
                                "null"
                              ],
                              "description": "分差绝对值最小值"
                            },
                            "score_diff_median": {
                              "type": [
                                "number",
                                "null"
                              ],
                              "description": "分差绝对值中位数，用于梯度判断"
                            },
                            "prefer_local": {
                              "type": "boolean",
                              "description": "是否启用本省优先排序"
                            },
                            "college_provinces": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "请求中用于过滤院校省份的列表"
                            },
                            "model_version": {
                              "type": "string",
                              "description": "模型版本号"
                            },
                            "probability_tiers": {
                              "type": [
                                "array",
                                "null"
                              ],
                              "items": {
                                "type": "object",
                                "additionalProperties": true
                              },
                              "description": "概率分层返回统计，仅在请求 probability_tiers 时返回；每项包含 name、label、min_probability、limit、returned_count，下一档会自动以上一档下限作为概率上界"
                            },
                            "tier_sort": {
                              "type": [
                                "string",
                                "null"
                              ],
                              "enum": [
                                "probability",
                                "college_rank",
                                "balanced",
                                null
                              ],
                              "description": "本次概率分层每档内部排序策略，仅在请求 probability_tiers 时返回"
                            },
                            "fallback": {
                              "type": [
                                "object",
                                "null"
                              ],
                              "additionalProperties": true
                            }
                          }
                        },
                        "disclaimer": {
                          "type": "string",
                          "description": "免责声明"
                        }
                      },
                      "description": "接口返回的业务数据。"
                    }
                  },
                  "description": "咕咕数据标准响应结构。"
                },
                "examples": {
                  "success": {
                    "summary": "预测成功",
                    "value": {
                      "DataStatus": {
                        "RequestParameter": "{\"province\": \"江苏\", \"subject_type\": \"物理类\", \"score\": 635, \"rank\": 12000, \"batch\": \"本科批\", \"top_n\": 10, \"include_explanation\": false, \"prefer_local\": false, \"college_provinces\": [\"江苏\", \"上海\"], \"target_colleges\": [\"南京大学\", \"东南大学\", \"南京航空航天大学\", \"南京理工大学\", \"苏州大学\", \"南京邮电大学\", \"河海大学\", \"江南大学\", \"上海大学\", \"华东理工大学\"], \"local_batch_name\": \"本科批\", \"year\": 2026}",
                        "StatusCode": 100,
                        "StatusDescription": "预测成功",
                        "ResponseDateTime": "2026-07-12 13:52:24.665",
                        "DataTotalCount": 7,
                        "RequestId": "dc85b98c-4ac6-4832-b7e7-3d5c247dd402"
                      },
                      "Data": {
                        "predictions": [
                          {
                            "college_name": "南京邮电大学",
                            "admission_probability": 0.8372396892372395,
                            "evidence": {
                              "recent_3y_min_score": [
                                623.0,
                                623.0
                              ],
                              "score_gap": 12.0,
                              "score_gap_original": 12.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": false,
                              "is_dual_class": true,
                              "college_rank": 122,
                              "plan_enrollment": 297,
                              "plan_coverage_ratio": 0.9179767600820232,
                              "major_hist_avg": 627.0,
                              "major_recent_min_trend": 0.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 29,
                              "covered_plan_total": 2686,
                              "school_plan_total": 2926
                            },
                            "shap_explanation": null,
                            "recommendation": "录取概率高",
                            "long_recommendation": "当前录取概率较高，按近年录取情况看，你的分数处于相对安全区间。你的分数高于近三年最低线12分，也高于近三年均值线12分。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "江南大学",
                            "admission_probability": 0.7834302033631845,
                            "evidence": {
                              "recent_3y_min_score": [
                                624.0,
                                600.0
                              ],
                              "score_gap": 27.799999999999955,
                              "score_gap_original": 11.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 57,
                              "plan_enrollment": 61,
                              "plan_coverage_ratio": 0.940554821664465,
                              "major_hist_avg": 627.0,
                              "major_recent_min_trend": 44.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 46,
                              "covered_plan_total": 712,
                              "school_plan_total": 757
                            },
                            "shap_explanation": null,
                            "recommendation": "需要注意梯度，但成功率较高",
                            "long_recommendation": "当前录取机会较大，但仍需关注同分段竞争和院校梯度波动。你的分数高于近三年最低线11分，也高于近三年均值线35分。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "苏州大学",
                            "admission_probability": 0.6957940753052466,
                            "evidence": {
                              "recent_3y_min_score": [
                                635.0,
                                636.0
                              ],
                              "score_gap": -0.7000000000000455,
                              "score_gap_original": 0.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 42,
                              "plan_enrollment": 130,
                              "plan_coverage_ratio": 0.8998971546109016,
                              "major_hist_avg": 636.0,
                              "major_recent_min_trend": -4.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 68,
                              "covered_plan_total": 2625,
                              "school_plan_total": 2917
                            },
                            "shap_explanation": null,
                            "recommendation": "需要注意梯度，但成功率较高",
                            "long_recommendation": "当前录取机会较大，但仍需关注同分段竞争和院校梯度波动。你的分数高于近三年最低线0分，但仍比近三年均值线低1分。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "河海大学",
                            "admission_probability": 0.46791220754157176,
                            "evidence": {
                              "recent_3y_min_score": [
                                629.0,
                                629.0
                              ],
                              "score_gap": 6.0,
                              "score_gap_original": 6.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 65,
                              "plan_enrollment": 95,
                              "plan_coverage_ratio": 0.8977871443624869,
                              "major_hist_avg": 633.0,
                              "major_recent_min_trend": 0.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 23,
                              "covered_plan_total": 852,
                              "school_plan_total": 949
                            },
                            "shap_explanation": null,
                            "recommendation": "需要注意梯度，但成功率较高",
                            "long_recommendation": "当前录取机会较大，但仍需关注同分段竞争和院校梯度波动。你的分数高于近三年最低线6分，也高于近三年均值线6分。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "东南大学",
                            "admission_probability": 0.3539651913843792,
                            "evidence": {
                              "recent_3y_min_score": [
                                644.0,
                                644.0
                              ],
                              "score_gap": -9.0,
                              "score_gap_original": -9.0,
                              "province_line_gap": 172.0,
                              "is_985": true,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 20,
                              "plan_enrollment": 87,
                              "plan_coverage_ratio": 0.7524875621890548,
                              "major_hist_avg": 649.0,
                              "major_recent_min_trend": 0.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 24,
                              "covered_plan_total": 605,
                              "school_plan_total": 804
                            },
                            "shap_explanation": null,
                            "recommendation": "录取概率低",
                            "long_recommendation": "当前录取概率偏低，按近年录取情况看仍有明显压力。你的分数比近三年最低线低9分，也比近三年均值线低9分。虽然你的分数高出本省控制线172分，但目标院校近年门槛整体更高。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。院校层次高、竞争强，通常会把整体录取分数要求拉高。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "南京理工大学",
                            "admission_probability": 0.2910228914369988,
                            "evidence": {
                              "recent_3y_min_score": [
                                642.0,
                                642.0
                              ],
                              "score_gap": -7.0,
                              "score_gap_original": -7.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 37,
                              "plan_enrollment": 60,
                              "plan_coverage_ratio": 0.7988165680473372,
                              "major_hist_avg": 643.0,
                              "major_recent_min_trend": 0.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 23,
                              "covered_plan_total": 405,
                              "school_plan_total": 507
                            },
                            "shap_explanation": null,
                            "recommendation": "录取概率低",
                            "long_recommendation": "当前录取概率偏低，按近年录取情况看仍有明显压力。你的分数比近三年最低线低7分，也比近三年均值线低7分。虽然你的分数高出本省控制线172分，但目标院校近年门槛整体更高。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。院校层次高、竞争强，通常会把整体录取分数要求拉高。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          },
                          {
                            "college_name": "南京航空航天大学",
                            "admission_probability": 0.27860252802394925,
                            "evidence": {
                              "recent_3y_min_score": [
                                645.0,
                                645.0
                              ],
                              "score_gap": -10.0,
                              "score_gap_original": -10.0,
                              "province_line_gap": 172.0,
                              "is_985": false,
                              "is_211": true,
                              "is_dual_class": true,
                              "college_rank": 47,
                              "plan_enrollment": 76,
                              "plan_coverage_ratio": 0.6012145748987854,
                              "major_hist_avg": 649.5,
                              "major_recent_min_trend": 0.0,
                              "aggregation_mode": "plan_weighted_school_probability",
                              "matched_plan_rows": 19,
                              "covered_plan_total": 297,
                              "school_plan_total": 494
                            },
                            "shap_explanation": null,
                            "recommendation": "录取概率低",
                            "long_recommendation": "当前录取概率偏低，按近年录取情况看仍有明显压力。你的分数比近三年最低线低10分，也比近三年均值线低10分。虽然你的分数高出本省控制线172分，但目标院校近年门槛整体更高。该结果按可匹配专业的招生计划加权汇总，更接近学校整体录取难度。院校层次高、竞争强，通常会把整体录取分数要求拉高。",
                            "major_name": null,
                            "tier_name": null,
                            "tier_label": null,
                            "tier_min_probability": null
                          }
                        ],
                        "meta": {
                          "total_colleges": 7,
                          "student_score": 635.0,
                          "student_province": "江苏",
                          "local_colleges": null,
                          "score_diff_min": 0.0,
                          "score_diff_median": 9.0,
                          "prefer_local": false,
                          "college_provinces": [
                            "江苏",
                            "上海"
                          ],
                          "model_version": "v1.1.0"
                        },
                        "disclaimer": "本预测结果综合历年真实招生数据、院校录取趋势与机器学习模型推算而成，仅供志愿填报参考。建议结合当年政策、院校最新官方信息及个人实际情况综合判断，最终录取结果以各省考试院和院校官方公布为准。"
                      }
                    }
                  },
                  "no_data": {
                    "summary": "有效请求暂无可用结果",
                    "value": {
                      "DataStatus": {
                        "RequestParameter": "province=江苏&subject_type=物理类&score=635&batch=本科批&year=2026",
                        "StatusCode": 100,
                        "StatusDescription": "暂无符合条件的预测结果",
                        "ResponseDateTime": "2026-07-01 21:30:00.000",
                        "DataTotalCount": 0,
                        "NoDataReason": "NO_MATCHING_COLLEGES"
                      },
                      "Data": {
                        "predictions": [],
                        "meta": {
                          "total_colleges": 0,
                          "local_colleges": 0,
                          "student_score": 635,
                          "student_province": "江苏",
                          "model_version": "v1.1.0"
                        },
                        "disclaimer": "录取参考概率仅用于辅助志愿梯度判断，不代表真实个人录取率或录取承诺。"
                      }
                    }
                  }
                }
              }
            }
          },
          "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/AdmissionErrorResponse"
                },
                "example": {
                  "DataStatus": {
                    "RequestParameter": "province=江苏&subject_type=物理类&score=635",
                    "StatusCode": -9,
                    "Status": "internal_error",
                    "StatusDescription": "预测服务内部错误，请稍后重试。",
                    "ResponseDateTime": "2026-07-01 21:30:00.000",
                    "DataTotalCount": 0,
                    "RequestId": "req_admission_demo_500"
                  },
                  "Data": null
                }
              }
            }
          },
          "502": {
            "description": "上游依赖错误。上游依赖服务不可用或返回异常。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CommonResponse"
                }
              }
            }
          },
          "422": {
            "description": "请求语义错误。请求格式正确，但参数取值、语义或业务约束无法处理。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionErrorResponse"
                },
                "example": {
                  "DataStatus": {
                    "RequestParameter": "",
                    "StatusCode": 501,
                    "Status": "invalid_argument",
                    "StatusDescription": "缺少必填参数: province",
                    "ResponseDateTime": "2026-07-01 21:30:00.000",
                    "DataTotalCount": 0,
                    "RequestId": "req_admission_demo_422"
                  },
                  "Data": null
                }
              }
            }
          },
          "503": {
            "description": "服务暂时不可用。依赖服务或预测服务暂时不可用，请稍后重试。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionErrorResponse"
                },
                "example": {
                  "DataStatus": {
                    "RequestParameter": "province=江苏&subject_type=物理类&score=635",
                    "StatusCode": -9,
                    "Status": "college_lookup_unavailable",
                    "StatusDescription": "学校信息查询暂时不可用，请稍后重试。",
                    "ResponseDateTime": "2026-07-01 21:30:00.000",
                    "DataTotalCount": 0,
                    "RequestId": "req_admission_demo_503"
                  },
                  "Data": null
                }
              }
            }
          },
          "504": {
            "description": "网关超时。预测服务未在时限内完成响应，请稍后重试。",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdmissionErrorResponse"
                },
                "example": {
                  "DataStatus": {
                    "RequestParameter": "province=江苏&subject_type=物理类&score=635",
                    "StatusCode": -9,
                    "Status": "upstream_unavailable",
                    "StatusDescription": "预测服务暂时不可用，请稍后重试。",
                    "ResponseDateTime": "2026-07-01 21:30:00.000",
                    "DataTotalCount": 0,
                    "RequestId": "req_admission_demo_504"
                  },
                  "Data": null
                }
              }
            }
          }
        },
        "x-gugudata-demo": {
          "method": "GET",
          "url": "https://api.gugudata.com/ai/admission/predict/demo"
        },
        "security": [
          {
            "AppKeyHeader": []
          },
          {
            "AppKeyQuery": []
          }
        ],
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": false,
            "description": "兼容历史客户端的 Query AppKey；新接入推荐使用 AppKey Header。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "province": {
                    "type": "string",
                    "description": "考生所在省份，与历年分数线数据保持一致"
                  },
                  "subject_type": {
                    "type": "string",
                    "description": "科类/选科：理科、文科、物理类、历史类、综合等"
                  },
                  "score": {
                    "type": "number",
                    "description": "考生裸分（0-750）"
                  },
                  "rank": {
                    "type": "integer",
                    "format": "int32",
                    "description": "考生全省位次，可为空（为空时结合分段位次推断）"
                  },
                  "batch": {
                    "type": "string",
                    "description": "报考批次，目前支持普通本科批次"
                  },
                  "top_n": {
                    "type": "integer",
                    "format": "int32",
                    "description": "返回院校数量上限，范围 1-200；传入 probability_tiers 时按各档位数量返回"
                  },
                  "probability_tiers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "description": "概率分层配置，仅支持 JSON Body 传入。示例：[{\"name\":\"safe\",\"label\":\"保\",\"min_probability\":0.98,\"limit\":3},{\"name\":\"stable\",\"label\":\"稳\",\"min_probability\":0.8,\"limit\":3},{\"name\":\"reach\",\"label\":\"冲\",\"min_probability\":0.75,\"limit\":3}]。每项包含 name、label、min_probability、limit；min_probability 必须严格递减，相邻档位自动形成概率区间；可配合 tier_sort 控制每档内部取数顺序，用于一次返回保、稳、冲等多档志愿结果；不传时继续按 top_n 返回。"
                  },
                  "tier_sort": {
                    "type": "string",
                    "description": "概率分层每档内部排序策略，仅在 probability_tiers 生效时使用；可选 probability、college_rank、balanced。probability 按录取概率排序，college_rank 按院校排名优先，balanced 综合院校层次、排名和概率。",
                    "enum": [
                      "probability",
                      "college_rank",
                      "balanced"
                    ]
                  },
                  "include_explanation": {
                    "type": "boolean",
                    "description": "是否返回 SHAP 补充解释，默认关闭以控制响应时延，开启后仅对部分结果返回解释信息"
                  },
                  "prefer_local": {
                    "type": "boolean",
                    "description": "是否在排序时优先本省院校"
                  },
                  "college_provinces": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "按院校所在省份过滤，留空则不过滤；Query 方式可多次传值，格式 [\"江苏\", \"上海\"]"
                  },
                  "target_colleges": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "指定院校名单，仅对名单内院校预测"
                  },
                  "uuid": {
                    "type": "string",
                    "description": "指定一个院校唯一 ID，仅对该院校预测；可使用全国大学高校基础信息接口返回的 SchoolUUID"
                  },
                  "target_college_uuids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "指定院校唯一 ID 列表，仅对名单内院校预测；多个值可使用数组或逗号分隔字符串"
                  },
                  "year": {
                    "type": "integer",
                    "format": "int32",
                    "description": "预测年份，用于匹配最新控制线与分数线"
                  },
                  "major_name": {
                    "type": "string",
                    "description": "专业名称（用于专业级预测），命中专业样本时优先返回该专业结果；若样本不足，系统可能切换到院校层或其他兼容预测路径"
                  },
                  "local_batch_name": {
                    "type": "string",
                    "description": "本地批次名称（用于过滤），不提供时默认使用 batch 参数的值"
                  },
                  "schoolUuid": {
                    "type": "string",
                    "description": "指定院校唯一 ID，兼容 camelCase 参数名。"
                  },
                  "schooluuid": {
                    "type": "string",
                    "description": "指定院校唯一 ID，兼容历史参数名。"
                  },
                  "SchoolUUID": {
                    "type": "string",
                    "description": "指定院校唯一 ID，兼容历史参数名。"
                  },
                  "uuids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "指定院校唯一 ID 列表。"
                  },
                  "targetCollegeUuids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "指定院校唯一 ID 列表，兼容 camelCase 参数名。"
                  }
                },
                "required": [
                  "province",
                  "subject_type",
                  "score"
                ]
              },
              "example": {
                "province": "江苏",
                "subject_type": "物理类",
                "score": 635,
                "rank": 12000,
                "batch": "本科批",
                "top_n": 3,
                "include_explanation": false,
                "prefer_local": false,
                "college_provinces": [
                  "江苏",
                  "上海"
                ],
                "target_colleges": [
                  "南京邮电大学"
                ],
                "year": 2026
              }
            }
          }
        }
      }
    },
    "/ai/article-polishing": {
      "post": {
        "summary": "文章自然润色",
        "description": "基于 AI 模型文章润色\n接口标签：AI、文本处理、专有模型、智能纠错\n接口特性：\n- 基于自有专业模型进行 AI 智能润色\n- 对原始内容进行智能纠错\n- 高效的文本润色性能\n- 围绕“文章自然润色”提供标准化能力，便于快速接入现有业务\n- 适合将“文章自然润色”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n- 可与摘要、翻译、关键词和情绪分析等接口组合使用\n详情页：https://www.gugudata.com/api/details/article-polishing",
        "operationId": "post_article_polishing",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/article-polishing"
        },
        "x-gugudata-api-identity": "article-polishing",
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "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/ai/article-polishing/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": "需要润色的文本内容"
                  },
                  "streaming": {
                    "type": "boolean",
                    "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。"
                  },
                  "writingStyle": {
                    "type": "string",
                    "description": "润色风格，例如学术性、正式、通俗、简洁等。"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "",
                "streaming": false
              }
            }
          }
        }
      }
    },
    "/ai/bazi-daily-insight": {
      "post": {
        "summary": "八字每日趋势解读",
        "description": "自有模型训练的每日节奏洞察\n接口标签：传统文化、八字趋势、每日解读、AI\n接口特性：\n- 接收姓名、性别、历法、出生日期、出生时间和地点等资料\n- 支持指定任意目标日期，不传时自动使用北京时间当天\n- 兼容公历、农历以及中英文性别和历法输入\n- 返回目标日期对应的农历、干支、生肖、星座和节气信息\n- 提供事业学习、关系沟通、生活节奏和行动提醒\n- 同一出生资料和目标日期可复用稳定的周期结果\n- 同时支持同步 JSON、异步任务和 SSE 流式响应\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/bazi-daily-insight",
        "operationId": "post_bazi_daily_insight",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/bazi-daily-insight"
        },
        "x-gugudata-api-identity": "bazi-daily-insight",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "Data": {
                      "type": "object",
                      "properties": {
                        "基础数据": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "出生资料和目标日期历法信息。"
                        },
                        "文化解读": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "每日主题、方向分析和行动建议。"
                        }
                      },
                      "description": "出生资料和目标日期历法信息。"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "咕咕数据标准响应结构。"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "description": "streaming=true 时返回 SSE 事件流，完成事件为 [DONE]。"
              }
            }
          },
          "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/ai/bazi-daily-insight/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。",
            "schema": {
              "type": "boolean",
              "enum": [
                "false",
                "true"
              ]
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profile": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "完整出生资料对象，gender、calendarType、birthDate、birthTime 为必填字段。",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "称呼，可选，最多 50 个字符。"
                      },
                      "gender": {
                        "type": "string",
                        "description": "性别，支持男、女、male、female、m、f，英文值会自动规范化。"
                      },
                      "calendarType": {
                        "type": "string",
                        "description": "出生日期历法，支持公历、农历、solar、gregorian、lunar。"
                      },
                      "birthDate": {
                        "type": "string",
                        "description": "出生日期，严格使用 YYYY-MM-DD 格式，并与 calendarType 对应。"
                      },
                      "birthTime": {
                        "type": "string",
                        "description": "出生时间，使用 HH:mm 或 HH:mm:ss 的 24 小时制格式。"
                      },
                      "birthPlace": {
                        "type": "string",
                        "description": "出生地点，可填写城市或地区名称，最多 100 个字符。"
                      },
                      "isLeapMonth": {
                        "type": "boolean",
                        "description": "农历生日是否为闰月；calendarType=农历时按实际情况设置。"
                      },
                      "language": {
                        "type": "string",
                        "description": "输出语言，支持 zh-CN、zh-TW、en-US。"
                      }
                    },
                    "required": [
                      "gender",
                      "calendarType",
                      "birthDate",
                      "birthTime"
                    ]
                  },
                  "targetDate": {
                    "type": "string",
                    "description": "需要解读的日期，使用 YYYY-MM-DD 格式；不传时默认为北京时间当天。"
                  }
                },
                "required": [
                  "profile"
                ]
              },
              "example": {
                "profile": "N/A",
                "profile.name": "N/A",
                "profile.gender": "女",
                "profile.calendarType": "公历",
                "profile.birthDate": "1990-12-01",
                "profile.birthTime": "07:00",
                "profile.birthPlace": "N/A",
                "profile.isLeapMonth": false,
                "profile.language": "zh-CN",
                "targetDate": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/bazi-fortune-teller": {
      "post": {
        "summary": "盲派八字推理",
        "description": "基于确定性历法排盘与自有模型解读的个人趋势参考\n接口标签：AI、八字命理、传统文化、命理分析、八字运势\n接口特性：\n- 支持结构化出生信息输入，并兼容现有 userinfo 自然语言调用\n- 先完成公历、农历与四柱排盘，再基于固定排盘基础生成文化解读\n- 明确返回标准化输入、历法换算、年柱、月柱、日柱和时柱，便于业务系统核对与展示\n- 支持同步、异步任务和 SSE 流式三种响应方式\n- 覆盖五行、大运、学业与事业、关系、财务和健康等文化解读维度\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/bazi-fortune-teller",
        "operationId": "post_bazi_fortune_teller",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/bazi-fortune-teller"
        },
        "x-gugudata-api-identity": "bazi-fortune-teller",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "请求成功。"
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "出生信息缺失、日期时间格式错误、历法值无效、农历闰月设置错误，或 task 与 streaming 参数冲突。"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "当前请求频率超过 APPKEY 的 QPS 限制。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效、已过期或未购买本接口。"
          }
        ],
        "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 表示成功；101 表示参数错误；102 表示请求频率受限；104 表示 APPKEY 无效或未购买本接口。"
                        },
                        "StatusDescription": {
                          "type": "string",
                          "description": "业务状态说明；参数错误时会指出缺少或格式不正确的字段。"
                        },
                        "ResponseDateTime": {
                          "type": "string",
                          "description": "接口响应生成时间。"
                        },
                        "DataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当前返回的业务结果数量；同步成功时通常为 1。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "排盘基础": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "由历法组件计算并固定返回的排盘依据，包含标准化输入、历法换算、四柱和八字。文化解读以此字段为准。",
                          "properties": {
                            "输入信息": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "标准化后的性别、历法、出生日期、出生时间、出生地点、闰月标识及时间标准化说明。"
                            },
                            "历法换算": {
                              "type": "object",
                              "properties": {
                                "公历时间": {
                                  "type": "string",
                                  "description": "排盘实际采用的公历时间，格式为 YYYY-MM-DD HH:mm:ss；农历输入会先换算为此时间。"
                                },
                                "农历日期": {
                                  "type": "string",
                                  "description": "排盘实际对应的农历日期。"
                                },
                                "时区": {
                                  "type": "string",
                                  "description": "排盘使用的时区，固定为 Asia/Shanghai。"
                                },
                                "日界规则": {
                                  "type": "string",
                                  "description": "日期换日规则。23:00 至 23:59 仍属于输入的公历日期，次日 00:00 后进入下一日。"
                                }
                              }
                            },
                            "四柱": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "确定性计算得到的年柱、月柱、日柱、时柱。"
                            }
                          }
                        },
                        "八字": {
                          "type": "string",
                          "description": "按年柱、月柱、日柱、时柱顺序拼接的八字结果，与 Data.排盘基础.四柱保持一致。"
                        },
                        "五行": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "基于排盘基础生成的五行属性、强弱及喜忌文化解读，具体子字段可能随命盘内容变化。"
                        },
                        "命宫": {
                          "type": "string",
                          "description": "命宫相关文化解读。"
                        },
                        "身宫": {
                          "type": "string",
                          "description": "身宫相关文化解读。"
                        },
                        "大运": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          },
                          "description": "分阶段的大运文化解读。每项通常包含起始年份、终止年份、干支或阶段主题，具体字段以实际返回为准。"
                        },
                        "运势分析": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "学业与事业、关系、财务、健康、体貌特征及关键阶段等维度的文化解读。"
                        },
                        "综合评价": {
                          "type": "string",
                          "description": "基于排盘基础生成的综合文化解读。"
                        },
                        "免责声明": {
                          "type": "string",
                          "description": "结果使用边界说明，仅供传统文化研究与娱乐参考。"
                        },
                        "operationId": {
                          "type": "string",
                          "description": "仅 responseMode=task 时返回，作为后续任务状态查询的唯一标识。"
                        },
                        "status": {
                          "type": "string",
                          "description": "仅任务模式返回，可能值为 PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。"
                        },
                        "pollingUrl": {
                          "type": "string",
                          "description": "仅任务模式返回，用于轮询任务状态的相对路径。"
                        },
                        "expiresAt": {
                          "type": "string",
                          "description": "仅任务模式返回，任务结果的过期时间。"
                        },
                        "result": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "任务状态为 SUCCEEDED 时返回的完整业务结果，字段结构与同步模式的 Data 相同。"
                        },
                        "error": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "任务状态为 FAILED 时返回的业务侧失败信息。"
                        }
                      },
                      "description": "由历法组件计算并固定返回的排盘依据，包含标准化输入、历法换算、四柱和八字。文化解读以此字段为准。"
                    },
                    "SSE": {
                      "type": "object",
                      "properties": {
                        "done": {
                          "type": "object",
                          "properties": {
                            "result": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "仅 streaming=true 时，在最后一个 type=done 消息中返回的完整且已校验结果。"
                            }
                          },
                          "description": "仅 streaming=true 时，在最后一个 type=done 消息中返回的完整且已校验结果。"
                        }
                      }
                    }
                  },
                  "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/ai/bazi-fortune-teller/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。false 返回完整 JSON；true 先发送 type=content 的文本片段，最后发送 type=done，其中 result 为包含确定性排盘基础的完整结果。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式，支持 sync、task。sync 在当前请求中返回结果；task 先返回 operationId，再调用任务状态查询接口轮询。responseMode=task 不能与 streaming=true 同时使用。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "userinfo": {
                    "type": "string",
                    "description": "旧版自然语言兼容参数。必须同时写明性别、历法、出生日期和出生时间，例如：我是男性，我的公历出生日期是2016年11月23日，出生时间是18:00。与结构化参数同时提供时，以 gender、calendarType、birthDate、birthTime 等结构化参数为准。"
                  },
                  "gender": {
                    "type": "string",
                    "description": "结构化调用时必填。性别，支持：男、女、male、female。",
                    "enum": [
                      "男",
                      "女",
                      "male",
                      "female"
                    ]
                  },
                  "calendarType": {
                    "type": "string",
                    "description": "结构化调用时必填。birthDate 使用的历法，支持：公历、农历、solar、gregorian、lunar。",
                    "enum": [
                      "公历",
                      "农历",
                      "solar",
                      "gregorian",
                      "lunar"
                    ]
                  },
                  "birthDate": {
                    "type": "string",
                    "description": "结构化调用时必填。出生日期，严格使用 YYYY-MM-DD 格式，支持范围为 1901-01-01 至 2100-12-31；calendarType=农历时填写农历年月日。"
                  },
                  "birthTime": {
                    "type": "string",
                    "description": "结构化调用时必填。出生时间，推荐使用 HH:mm 24 小时制，例如 18:00。支持丑时至亥时等传统时辰输入，并按该时辰的中间时刻标准化；子时跨越两个公历日期，必须改用 HH:mm 明确具体时间。"
                  },
                  "birthPlace": {
                    "type": "string",
                    "description": "出生地点，用于文化解读背景。当前排盘统一按 Asia/Shanghai 时区和输入的北京时间计算，不根据经度进行真太阳时校正。"
                  },
                  "isLeapMonth": {
                    "type": "boolean",
                    "description": "仅 calendarType=农历时有效。出生月份是否为闰月；公历输入必须为 false。"
                  }
                }
              },
              "example": {
                "userinfo": "N/A",
                "gender": "N/A",
                "calendarType": "公历",
                "birthDate": "N/A",
                "birthTime": "N/A",
                "birthPlace": "N/A",
                "isLeapMonth": false
              }
            }
          }
        }
      }
    },
    "/ai/bazi-relationship-insight": {
      "post": {
        "summary": "八字关系合参",
        "description": "自有模型训练的双人关系洞察\n接口标签：传统文化、八字关系、关系分析、AI\n接口特性：\n- 分别接收双方姓名、性别、历法、出生日期、出生时间和地点\n- 兼容公历、农历以及中英文性别和历法输入\n- 可指定沟通、家庭、价值观等最多六个重点分析方向\n- 基础出生资料与历法字段独立返回，不被文化解读改写\n- 提供关系摘要、互补特点、沟通节奏和长期相处建议\n- 同时支持同步 JSON、异步任务和 SSE 流式响应\n- 统一使用标准响应结构，便于服务端和前端应用接入\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/bazi-relationship-insight",
        "operationId": "post_bazi_relationship_insight",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/bazi-relationship-insight"
        },
        "x-gugudata-api-identity": "bazi-relationship-insight",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "Data": {
                      "type": "object",
                      "properties": {
                        "基础数据": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "双方规范化出生资料与历法基础信息。"
                        },
                        "文化解读": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "关系摘要、互补特点与相处建议。"
                        },
                        "免责声明": {
                          "type": "string",
                          "description": "传统文化研究与娱乐参考说明。"
                        }
                      },
                      "description": "双方规范化出生资料与历法基础信息。"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "咕咕数据标准响应结构。"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "description": "streaming=true 时返回 SSE 事件流，完成事件为 [DONE]。"
              }
            }
          },
          "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/ai/bazi-relationship-insight/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。",
            "schema": {
              "type": "boolean",
              "enum": [
                "false",
                "true"
              ]
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "personA": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "甲方完整出生资料对象，gender、calendarType、birthDate、birthTime 为必填字段。",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "甲方称呼，可选，最多 50 个字符，仅用于区分双方。"
                      },
                      "gender": {
                        "type": "string",
                        "description": "甲方性别，支持男、女、male、female、m、f，英文值会自动规范化。"
                      },
                      "calendarType": {
                        "type": "string",
                        "description": "甲方出生日期历法，支持公历、农历、solar、gregorian、lunar。"
                      },
                      "birthDate": {
                        "type": "string",
                        "description": "甲方出生日期，严格使用 YYYY-MM-DD 格式，并与 calendarType 对应。"
                      },
                      "birthTime": {
                        "type": "string",
                        "description": "甲方出生时间，使用 HH:mm 或 HH:mm:ss 的 24 小时制格式。"
                      },
                      "birthPlace": {
                        "type": "string",
                        "description": "甲方出生地点，可填写城市或地区名称，最多 100 个字符。"
                      },
                      "isLeapMonth": {
                        "type": "boolean",
                        "description": "甲方农历生日是否为闰月；calendarType=农历时按实际情况设置。"
                      },
                      "language": {
                        "type": "string",
                        "description": "甲方资料对应的输出语言，支持 zh-CN、zh-TW、en-US。"
                      }
                    },
                    "required": [
                      "gender",
                      "calendarType",
                      "birthDate",
                      "birthTime"
                    ]
                  },
                  "personB": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "乙方完整出生资料对象，字段规则与 personA 相同。",
                    "properties": {
                      "name": {
                        "type": "string",
                        "description": "乙方称呼，可选，最多 50 个字符，仅用于区分双方。"
                      },
                      "gender": {
                        "type": "string",
                        "description": "乙方性别，支持男、女、male、female、m、f，英文值会自动规范化。"
                      },
                      "calendarType": {
                        "type": "string",
                        "description": "乙方出生日期历法，支持公历、农历、solar、gregorian、lunar。"
                      },
                      "birthDate": {
                        "type": "string",
                        "description": "乙方出生日期，严格使用 YYYY-MM-DD 格式，并与 calendarType 对应。"
                      },
                      "birthTime": {
                        "type": "string",
                        "description": "乙方出生时间，使用 HH:mm 或 HH:mm:ss 的 24 小时制格式。"
                      },
                      "birthPlace": {
                        "type": "string",
                        "description": "乙方出生地点，可填写城市或地区名称，最多 100 个字符。"
                      },
                      "isLeapMonth": {
                        "type": "boolean",
                        "description": "乙方农历生日是否为闰月；calendarType=农历时按实际情况设置。"
                      },
                      "language": {
                        "type": "string",
                        "description": "乙方资料对应的输出语言，支持 zh-CN、zh-TW、en-US。"
                      }
                    },
                    "required": [
                      "gender",
                      "calendarType",
                      "birthDate",
                      "birthTime"
                    ]
                  },
                  "focusAreas": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "希望重点分析的方向，最多 6 项，例如沟通、家庭、价值观、长期相处。为空时使用默认方向。"
                  }
                },
                "required": [
                  "personA",
                  "personB"
                ]
              },
              "example": {
                "personA": "N/A",
                "personB": "N/A",
                "personA.name": "N/A",
                "personA.gender": "男",
                "personA.calendarType": "公历",
                "personA.birthDate": "1990-12-01",
                "personA.birthTime": "07:00",
                "personA.birthPlace": "N/A",
                "personA.isLeapMonth": false,
                "personA.language": "zh-CN",
                "personB.name": "N/A",
                "personB.gender": "女",
                "personB.calendarType": "公历",
                "personB.birthDate": "1992-06-15",
                "personB.birthTime": "09:30",
                "personB.birthPlace": "N/A",
                "personB.isLeapMonth": false,
                "personB.language": "zh-CN",
                "focusAreas": []
              }
            }
          }
        }
      }
    },
    "/ai/children-story-creator": {
      "post": {
        "summary": "儿童故事创作大师",
        "description": "基于 AI 模型智能创作儿童故事\n接口标签：AI、故事创作、儿童故事\n接口特性：\n- 支持多种主题和长度的儿童故事创作\n- 基于 AI 模型，提供高质量的故事内容\n- 附带教育意义的反思内容\n- 适用于教育、娱乐和家庭阅读场景\n- 围绕“儿童故事创作大师”提供标准化能力，便于快速接入现有业务\n- 适合将“儿童故事创作大师”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n详情页：https://www.gugudata.com/api/details/children-story-creator",
        "operationId": "post_children_story_creator",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/children-story-creator"
        },
        "x-gugudata-api-identity": "children-story-creator",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": {
                        "content": {
                          "type": "string",
                          "description": "生成的故事内容"
                        },
                        "reflection": {
                          "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/ai/children-story-creator/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "type": "string",
                    "description": "故事的一句话主题，如：刻意练习对于学习的意义"
                  },
                  "length": {
                    "type": "string",
                    "description": "故事长度，可选参数为：短篇|中篇|长篇"
                  }
                },
                "required": [
                  "topic",
                  "length"
                ]
              },
              "example": {
                "topic": "N/A",
                "length": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/chinese-zodiac-period-insight": {
      "post": {
        "summary": "生肖周期趋势解读",
        "description": "生肖周期趋势的智能解读\n接口标签：生肖、周期趋势、传统文化、AI\n接口特性：\n- 支持直接传入生肖名称或通过出生年份自动换算\n- 严格校验生肖与出生年份二选一，避免输入含义冲突\n- 覆盖今日、明日、本周、本月和本年五种周期\n- 周期起止标识按北京时间和目标日期自动规范化\n- 生肖归属由本地确定性规则计算，不受文化解读影响\n- 提供周期主题、事业学习、关系沟通和生活提醒\n- 同时支持同步 JSON、异步任务和 SSE 流式响应\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/chinese-zodiac-period-insight",
        "operationId": "post_chinese_zodiac_period_insight",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/chinese-zodiac-period-insight"
        },
        "x-gugudata-api-identity": "chinese-zodiac-period-insight",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "Data": {
                      "type": "object",
                      "properties": {
                        "基础数据": {
                          "type": "object",
                          "properties": {
                            "生肖": {
                              "type": "string",
                              "description": "规范化生肖。"
                            },
                            "周期标识": {
                              "type": "string",
                              "description": "本次结果对应的周期。"
                            }
                          }
                        },
                        "文化解读": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "周期主题、方向分析与提醒。"
                        }
                      },
                      "description": "周期主题、方向分析与提醒。"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "咕咕数据标准响应结构。"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "description": "streaming=true 时返回 SSE 事件流，完成事件为 [DONE]。"
              }
            }
          },
          "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/ai/chinese-zodiac-period-insight/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。",
            "schema": {
              "type": "boolean",
              "enum": [
                "false",
                "true"
              ]
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "zodiac": {
                    "type": "string",
                    "description": "十二生肖名称，支持鼠、牛、虎、兔、龙、蛇、马、羊、猴、鸡、狗、猪；与 birthYear 必须且只能传一个。"
                  },
                  "birthYear": {
                    "type": "integer",
                    "format": "int32",
                    "description": "出生年份，范围 1900–2100，系统会按本地规则换算生肖；与 zodiac 必须且只能传一个。"
                  },
                  "period": {
                    "type": "string",
                    "description": "解读周期：today 今日、tomorrow 明日、week 本周、month 本月、year 本年。"
                  },
                  "targetDate": {
                    "type": "string",
                    "description": "周期计算基准日期，使用 YYYY-MM-DD 格式；不传时默认为北京时间当天。"
                  },
                  "language": {
                    "type": "string",
                    "description": "输出语言，支持 zh-CN、zh-TW、en-US。"
                  }
                }
              },
              "example": {
                "zodiac": "马",
                "birthYear": "N/A",
                "period": "today",
                "targetDate": "N/A",
                "language": "zh-CN"
              }
            }
          }
        }
      }
    },
    "/ai/college-score": {
      "post": {
        "summary": "高校评分实时分析与推荐",
        "description": "高校评分与推荐分析\n接口标签：基础数据、高校高考、多维度评估、专业推荐\n接口特性：\n- POST JSON body 传入 universityName，支持中文或英文高校名称\n- 返回综合评分、6 个维度分项得分、分项分析、综合评价和推荐理由\n- 支持 streaming=true 使用 SSE 流式返回评分过程，streaming=false 返回标准 JSON\n- 适合院校对比、择校推荐、学校详情页评分摘要等场景\n- 围绕“高校评分实时分析与推荐”提供标准化能力，便于快速接入现有业务\n- 适合将“高校评分实时分析与推荐”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/college-score",
        "operationId": "post_college_score",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/college-score"
        },
        "x-gugudata-api-identity": "college-score",
        "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": {
                        "university": {
                          "type": "string",
                          "description": "参与评分的大学名称。"
                        },
                        "scores": {
                          "type": "object",
                          "properties": {
                            "academic_reputation": {
                              "type": "integer",
                              "format": "int32",
                              "description": "学术声誉得分。"
                            },
                            "employment_prospects": {
                              "type": "integer",
                              "format": "int32",
                              "description": "就业前景得分。"
                            },
                            "tuition_and_scholarships": {
                              "type": "integer",
                              "format": "int32",
                              "description": "学费与奖助体系得分。"
                            },
                            "student_life_and_campus": {
                              "type": "integer",
                              "format": "int32",
                              "description": "学生生活与校园环境得分。"
                            },
                            "programs_and_curriculum": {
                              "type": "integer",
                              "format": "int32",
                              "description": "学科专业与课程设置得分。"
                            },
                            "teaching_quality": {
                              "type": "integer",
                              "format": "int32",
                              "description": "教学质量得分。"
                            }
                          }
                        },
                        "total_score": {
                          "type": "integer",
                          "format": "int32",
                          "description": "综合评分，范围 0~100。"
                        },
                        "analysis": {
                          "type": "object",
                          "properties": {
                            "academic_reputation": {
                              "type": "string",
                              "description": "学术声誉维度分析。"
                            },
                            "employment_prospects": {
                              "type": "string",
                              "description": "就业前景维度分析。"
                            },
                            "tuition_and_scholarships": {
                              "type": "string",
                              "description": "学费与奖助体系维度分析。"
                            },
                            "student_life_and_campus": {
                              "type": "string",
                              "description": "学生生活与校园环境维度分析。"
                            },
                            "programs_and_curriculum": {
                              "type": "string",
                              "description": "学科专业与课程设置维度分析。"
                            },
                            "teaching_quality": {
                              "type": "string",
                              "description": "教学质量维度分析。"
                            }
                          }
                        },
                        "long_recommendation": {
                          "type": "string",
                          "description": "院校推荐理由与适配建议。"
                        },
                        "long_summary": {
                          "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/ai/college-score/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": {
                  "universityName": {
                    "type": "string",
                    "description": "请求体 JSON 字段，需要评分分析的大学名称，可以传中文名、英文名、简称或全称。"
                  },
                  "streaming": {
                    "type": "boolean",
                    "description": "Query 参数，是否启用流式输出，默认 false；true 时响应为 SSE，false 时返回标准 JSON。"
                  }
                },
                "required": [
                  "universityName"
                ]
              },
              "example": {
                "universityName": "",
                "streaming": false
              }
            }
          }
        }
      }
    },
    "/ai/gaokao/chat": {
      "post": {
        "summary": "高考教育信息智能助手",
        "description": "高考教育信息智能问答助手\n接口标签：AI、高考、高考录取、高等教育、智能问答、知识库检索、多轮对话\n接口特性：\n- RAG 智能体，强大的 AI 问答能力，支持高校基础信息查询、招生政策解读、专业介绍与选择建议等\n- 支持招生政策解读、报考指南与志愿填报建议\n- 支持多轮对话，通过 session_id 保持对话上下文\n- 支持知识库检索（RAG），可指定检索范围\n- 支持流式输出（SSE），实时返回 AI 生成内容\n- 支持多种请求方式：JSON、Form、Query String\n- 围绕“高考教育信息智能助手”提供标准化能力，便于快速接入现有业务\n- 适合将“高考教育信息智能助手”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/gaokao-chat",
        "operationId": "post_gaokao_chat",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/gaokao-chat"
        },
        "x-gugudata-api-identity": "gaokao-chat",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请检查传递的参数是否完整，prompt 和 appkey 为必填参数"
          },
          {
            "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": "object",
                      "properties": {
                        "text": {
                          "type": "string",
                          "description": "回复的文本内容"
                        },
                        "session_id": {
                          "type": "string",
                          "description": "会话ID，用于多轮对话。首次请求会自动生成，后续请求使用此 ID 可保持对话上下文"
                        },
                        "finish_reason": {
                          "type": "string",
                          "description": "完成原因，通常为 'stop' 表示正常完成"
                        },
                        "request_id": {
                          "type": "string",
                          "description": "请求ID，用于追踪和调试"
                        }
                      },
                      "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/ai/gaokao/chat/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": {
                  "prompt": {
                    "type": "string",
                    "description": "用户输入的问题，支持通过 JSON body 或 Form 参数传入"
                  },
                  "session_id": {
                    "type": "string",
                    "description": "会话ID，用于多轮对话。首次请求可不传，系统会自动生成并返回；后续请求使用返回的 session_id 可保持对话上下文"
                  },
                  "streaming": {
                    "type": "string",
                    "description": "是否启用流式输出（true/false），流式输出采用 SSE (Server-Sent Events) 格式，可通过 Query 参数或 JSON body 传入",
                    "enum": [
                      "true",
                      "false"
                    ]
                  },
                  "pipeline_ids": {
                    "type": "string",
                    "description": "知识库 ID 列表，多个值用英文逗号分隔。"
                  }
                },
                "required": [
                  "prompt"
                ]
              },
              "example": {
                "prompt": "你好，请介绍一下你自己",
                "session_id": "",
                "streaming": false
              }
            }
          }
        }
      }
    },
    "/ai/grammar-correction": {
      "post": {
        "summary": "多语言文本 AI 纠错格式化",
        "description": "AI 模型智能纠正\n接口标签：AI、文本处理、语法纠错、文本格式化\n接口特性：\n- 支持多语言文本的语法纠错\n- 自动识别并纠正拼写错误、语法错误和标点符号使用不当\n- 优化文本格式，提高可读性\n- 基于AI模型，持续学习和更新，提高纠错准确率\n- 适用于文档校对、写作辅助、教育等多个领域\n- 围绕“多语言文本 AI 纠错格式化”提供标准化能力，便于快速接入现有业务\n- 适合将“多语言文本 AI 纠错格式化”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n详情页：https://www.gugudata.com/api/details/grammar-correction",
        "operationId": "post_grammar_correction",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/grammar-correction"
        },
        "x-gugudata-api-identity": "grammar-correction",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "corrected_text": {
                          "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/ai/grammar-correction/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "textContent": {
                    "type": "string",
                    "description": "需要进行语法纠错和格式化的文本内容"
                  }
                },
                "required": [
                  "textContent"
                ]
              },
              "example": {
                "textContent": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/image-compress": {
      "post": {
        "summary": "图片压缩与尺寸优化",
        "description": "图片压缩优化，保持长宽比，保证清晰度\n接口标签：图片压缩、图片处理、图片优化、尺寸调整\n接口特性：\n- 支持本地上传图片或网络图片 URL，一键完成压缩\n- 自动保持图片长宽比，可按目标尺寸或最大尺寸进行等比缩放\n- 针对 JPEG 采用优化压缩（渐进式、优化 Huffman 表等），在保证清晰度的前提下显著减小体积\n- 支持 PNG 等无损格式的体积优化压缩\n- 自动限制过大图片的尺寸（默认 1920 像素上限），避免带宽浪费\n- 围绕“图片压缩与尺寸优化”提供标准化能力，便于快速接入现有业务\n- 适合将“图片压缩与尺寸优化”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n详情页：https://www.gugudata.com/api/details/image-compress",
        "operationId": "post_image_compress",
        "tags": [
          "图像与文档转换接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/image-compress"
        },
        "x-gugudata-api-identity": "image-compress",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "appkey 缺失，image_file 与 image_url 均为空，或 quality/尺寸参数不合法"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每秒请求不能超过平台限制"
          },
          {
            "code": "103",
            "title": "账号欠费",
            "remark": ""
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "110",
            "title": "图片格式不支持或文件损坏",
            "remark": "Pillow 无法识别图片，或图片超过最大限制（当前为 10MB）"
          },
          {
            "code": "111",
            "title": "图片下载失败",
            "remark": "当通过 image_url 下载图片失败或超时时返回"
          },
          {
            "code": "112",
            "title": "服务内部错误",
            "remark": "压缩过程中发生未预期异常"
          }
        ],
        "responses": {
          "200": {
            "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "HTTP Header": {
                      "type": "object",
                      "properties": {
                        "Content-Type": {
                          "type": "string",
                          "description": "返回图片的 MIME 类型，例如 image/jpeg、image/png 等"
                        },
                        "Content-Disposition": {
                          "type": "string",
                          "description": "文件下载头，包含建议的下载文件名，默认会根据原始文件名和格式自动生成"
                        }
                      }
                    },
                    "Body(Binary)": {
                      "type": "string",
                      "format": "binary",
                      "description": "压缩后图片的二进制流内容，可直接保存为图片文件或在浏览器中显示"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/ai/image-compress/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": {
                  "image_file": {
                    "type": "string",
                    "format": "binary",
                    "description": "上传的图片文件，支持 JPG / JPEG / PNG / GIF / WEBP / BMP，与 image_url 二选一必填"
                  },
                  "image_url": {
                    "type": "string",
                    "description": "网络图片 URL，与 image_file 二选一必填，需为可直接访问的 HTTP/HTTPS 链接"
                  },
                  "targetWidth": {
                    "type": "integer",
                    "format": "int32",
                    "description": "目标宽度（像素），与 targetHeight 组合使用时按照最长边等比缩放；不传则不以此为约束"
                  },
                  "targetHeight": {
                    "type": "integer",
                    "format": "int32",
                    "description": "目标高度（像素），与 targetWidth 组合使用时按照最长边等比缩放；不传则不以此为约束"
                  },
                  "maxWidth": {
                    "type": "integer",
                    "format": "int32",
                    "description": "最大宽度（像素），只限制不超过该宽度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限"
                  },
                  "maxHeight": {
                    "type": "integer",
                    "format": "int32",
                    "description": "最大高度（像素），只限制不超过该高度并保持长宽比；当未显式传递任何尺寸参数且图片特别大时，服务会自动使用 1920 作为默认上限"
                  },
                  "quality": {
                    "type": "integer",
                    "format": "int32",
                    "description": "JPEG 压缩质量，取值范围 1-95，数值越低压缩越厉害，推荐在 60-90 之间；PNG 等无损格式将使用内部优化策略忽略该参数"
                  },
                  "format": {
                    "type": "string",
                    "description": "输出图片格式，可选值：jpeg、png 等；不传则保持原图格式（对于部分不常见格式会自动转换为 JPEG）",
                    "enum": [
                      "jpeg",
                      "png 等"
                    ]
                  }
                }
              },
              "example": {
                "image_url": "",
                "targetWidth": 0,
                "targetHeight": 0,
                "maxWidth": 0,
                "maxHeight": 0,
                "quality": 85,
                "format": ""
              }
            }
          }
        }
      }
    },
    "/ai/keyword-extraction": {
      "post": {
        "summary": "多语言长文本 AI 关键字提取",
        "description": "专有模型极速提取\n接口标签：AI、文本、多语言长文本、实时语料库\n接口特性：\n- 支持长文本关键词提取\n- 多语言关键词识别\n- 基于 AI 模型，提取精准关键词\n- 围绕“多语言长文本 AI 关键字提取”提供标准化能力，便于快速接入现有业务\n- 适合将“多语言长文本 AI 关键字提取”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n- 支持将处理结果接入文档工作台、审批系统和归档系统\n详情页：https://www.gugudata.com/api/details/keyword-extraction",
        "operationId": "post_keyword_extraction",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/keyword-extraction"
        },
        "x-gugudata-api-identity": "keyword-extraction",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "keywords": {
                          "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/ai/keyword-extraction/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "textContent": {
                    "type": "string",
                    "description": "需要提取关键词的文本内容"
                  },
                  "keywordMaxLength": {
                    "type": "integer",
                    "format": "int32",
                    "description": "单个关键字长度限制，不传递默认长度为 5 个字符"
                  }
                },
                "required": [
                  "textContent"
                ]
              },
              "example": {
                "textContent": "N/A",
                "keywordMaxLength": 5
              }
            }
          }
        }
      }
    },
    "/ai/knowledge-bases/{knowledge_base_id}/chat/completions": {
      "post": {
        "summary": "AI RAG 文档知识库问答",
        "description": "私有文档 AI 知识库问答\n接口标签：AI、RAG、知识库、文档问答、流式响应\n接口特性：\n- 支持上传 API 文档、产品说明、协议和帮助文档等资料构建私有知识库\n- 支持 PDF、TXT、Markdown、HTML 和 DOCX 文档上传\n- 上传后返回 document_id、解析状态、分块数量和入库状态，便于客户侧确认知识库构建结果\n- 支持知识库分组与客户侧业务分组，适合多产品、多项目或多客户场景\n- 支持基于线程的连续追问，适合嵌入客服、开发者门户和内部知识系统\n- 支持 OpenAI Chat Completions 兼容 JSON 与 SSE 流式响应\n- 回答结果包含引用来源，便于追溯内容依据\n- 客户文档仅用于当前知识库问答，不用于训练公共模型\n详情页：https://www.gugudata.com/api/details/knowledge-chat",
        "operationId": "post_knowledge_chat",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/knowledge-chat"
        },
        "x-gugudata-api-identity": "knowledge-chat",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "请求成功",
            "remark": "接口正常返回"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查请求参数、文件大小或文件格式"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "知识库处理或问答过程中发生异常"
          }
        ],
        "responses": {
          "200": {
            "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "当前回答消息 ID"
                    },
                    "object": {
                      "type": "string",
                      "description": "OpenAI 兼容响应对象类型"
                    },
                    "thread_id": {
                      "type": "string",
                      "description": "当前对话线程 ID"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "message": {
                            "type": "object",
                            "properties": {
                              "content": {
                                "type": "string",
                                "description": "基于已上传文档生成的回答"
                              }
                            }
                          }
                        }
                      }
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "回答引用的文档来源片段"
                    },
                    "usage": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "本次请求的使用量摘要"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/ai/knowledge-bases/default/chat/completions"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "knowledge_base_id",
            "in": "path",
            "required": true,
            "description": "URL 路径中的知识库标识",
            "schema": {
              "type": "string"
            },
            "example": "default"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string",
                    "description": "OpenAI Chat Completions 兼容模型名称"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "OpenAI Chat Completions 兼容消息数组"
                  },
                  "thread_id": {
                    "type": "string",
                    "description": "对话线程 ID，不传时自动创建新线程"
                  },
                  "tenant_id": {
                    "type": "string",
                    "description": "客户侧业务分组标识"
                  },
                  "stream": {
                    "type": "boolean",
                    "description": "是否使用 SSE 流式响应"
                  },
                  "top_k": {
                    "type": "integer",
                    "format": "int32",
                    "description": "检索引用片段数量"
                  }
                },
                "required": [
                  "messages"
                ]
              },
              "example": {
                "model": "gugudata-knowledge-chat",
                "messages": [
                  {
                    "role": "user",
                    "content": "有哪些接口？"
                  }
                ],
                "thread_id": "",
                "tenant_id": "default",
                "stream": false,
                "top_k": 6
              }
            }
          }
        }
      }
    },
    "/ai/knowledge-bases/{knowledge_base_id}/documents": {
      "post": {
        "summary": "上传知识库文档",
        "description": "上传文档并构建私有知识库\n接口标签：AI、RAG、知识库、文档问答、流式响应\n详情页：https://www.gugudata.com/api/details/knowledge-chat",
        "operationId": "post_post_ai_knowledge_bases_knowledge_base_id_documents",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/knowledge-chat"
        },
        "x-gugudata-api-identity": "knowledge-chat",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "请求成功",
            "remark": "接口正常返回"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查请求参数、文件大小或文件格式"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "-1",
            "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": "object",
                      "properties": {
                        "knowledge_base_id": {
                          "type": "string"
                        },
                        "documents": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "document_id": {
                                "type": "string"
                              },
                              "file_name": {
                                "type": "string"
                              },
                              "file_size": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "status": {
                                "type": "string"
                              },
                              "parse_status": {
                                "type": "string"
                              },
                              "index_status": {
                                "type": "string"
                              },
                              "chunk_count": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "token_estimate": {
                                "type": "integer",
                                "format": "int32"
                              }
                            }
                          }
                        }
                      },
                      "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": "knowledge-chat",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/knowledge-chat",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "knowledge_base_id",
            "in": "path",
            "required": true,
            "description": "URL 路径中的知识库标识，默认可使用 default",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "string",
                    "format": "binary",
                    "description": "待上传文档，支持 PDF、TXT、Markdown、HTML 和 DOCX；单次最多 5 个文件，单文件最大 20MB"
                  },
                  "tenant_id": {
                    "type": "string",
                    "description": "客户侧业务分组标识，不传时使用 default"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "客户自定义元数据，需为 JSON 对象"
                  },
                  "replace_existing": {
                    "type": "boolean",
                    "description": "是否替换同知识库下已有同名文档，默认 false"
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "tenant_id": "",
                "metadata": {},
                "replace_existing": false
              }
            }
          }
        }
      }
    },
    "/ai/multilingual-translation": {
      "post": {
        "summary": "多语言 AI 翻译",
        "description": "基于 AI 多语言模型\n接口标签：AI、翻译、支持多语言、基于模型\n接口特性：\n- 基于自有专业模型进行 AI 多语言翻译\n- 高效的文本翻译性能\n- 围绕“多语言 AI 翻译”提供标准化能力，便于快速接入现有业务\n- 适合将“多语言 AI 翻译”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n- 可与摘要、翻译、关键词和情绪分析等接口组合使用\n- 便于对输入文本进行批量处理、人工复核和结果归档\n详情页：https://www.gugudata.com/api/details/multilingual-translation",
        "operationId": "post_multilingual_translation",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/multilingual-translation"
        },
        "x-gugudata-api-identity": "multilingual-translation",
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "translated_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/ai/multilingual-translation/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": "需要翻译的文本内容"
                  },
                  "language": {
                    "type": "string",
                    "description": "目标语言，目标语言支持自然语言或者 ISO 639 language code，如日语、日文、jp、japanese"
                  },
                  "streaming": {
                    "type": "boolean",
                    "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。"
                  }
                },
                "required": [
                  "content",
                  "language"
                ]
              },
              "example": {
                "content": "",
                "language": "",
                "streaming": false
              }
            }
          }
        }
      }
    },
    "/ai/name-generator": {
      "post": {
        "summary": "八字喜用神起名大师",
        "description": "自有模型训练的五行数理起名建议\n接口标签：姓名、八字命理、传统文化、AI、十年模型积累、三才五格数理\n接口特性：\n- 基于传统八字命理学理论\n- 结合三才五格数理分析\n- 考虑五行相生相克关系\n- 提供多个候选姓名供选择\n- 包含详细的命理分析报告\n- 支持方言谐音检测\n- 支持 responseMode=task 任务模式，先返回 operationId，再通过轮询接口查询结果\n- 围绕“八字喜用神起名大师”提供标准化能力，便于快速接入现有业务\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/name-generator",
        "operationId": "post_name_generator",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/name-generator"
        },
        "x-gugudata-api-identity": "name-generator",
        "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",
                      "additionalProperties": true,
                      "description": "接口返回的完整 JSON 数据，包含命盘分析、候选名字清单、最佳推荐、注意事项等所有字段，具体可查看 <a href='https://www.gugudata.com/preview/name-generator' target='_blank'>DEMO 接口</a> 返回数据",
                      "properties": {
                        "operationId": {
                          "type": "string",
                          "description": "仅 responseMode=task 时返回，任务唯一标识。"
                        },
                        "status": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，状态枚举：PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。"
                        },
                        "pollingUrl": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，任务状态查询地址。"
                        },
                        "expiresAt": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，任务结果过期时间。"
                        },
                        "result": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "仅任务状态为 SUCCEEDED 时返回，业务结果结构与同步模式一致。"
                        },
                        "error": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "仅任务状态为 FAILED 时返回，失败原因信息。"
                        }
                      }
                    }
                  },
                  "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/ai/name-generator/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。当 responseMode=task 时，streaming 必须为 false。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式，可选值：sync、task。为 task 时立即返回任务受理结果，不阻塞等待模型完成。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "lastname": {
                    "type": "string",
                    "description": "姓氏"
                  },
                  "gender": {
                    "type": "string",
                    "description": "性别（男/女）"
                  },
                  "birthDateTime": {
                    "type": "string",
                    "description": "公历出生年月日时，格式：YYYY年MM月DD日 HH:MM"
                  },
                  "birthPlace": {
                    "type": "string",
                    "description": "出生地点（省市），用于规避可能的谐音"
                  },
                  "parentNames": {
                    "type": "string",
                    "description": "父母姓名（可选，用于亲子音韵搭配）"
                  },
                  "avoidWords": {
                    "type": "string",
                    "description": "可选避用字（可选，多个字用逗号分隔）"
                  },
                  "avoidNames": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "禁生成姓名，支持逗号分隔字符串或 JSON 数组"
                  }
                },
                "required": [
                  "lastname",
                  "gender",
                  "birthDateTime",
                  "birthPlace"
                ]
              },
              "example": {
                "lastname": "",
                "gender": "",
                "birthDateTime": "N/A",
                "birthPlace": "N/A",
                "parentNames": "",
                "avoidWords": "",
                "avoidNames": []
              }
            }
          }
        }
      }
    },
    "/ai/operations/{operation_id}": {
      "get": {
        "summary": "任务状态查询",
        "description": "轮询异步任务状态，任务成功时在 Data.result 返回业务结果。\n接口标签：传统文化、八字关系、关系分析、AI\n详情页：https://www.gugudata.com/api/details/bazi-relationship-insight",
        "operationId": "get_get_ai_operations_operation_id",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/bazi-relationship-insight"
        },
        "x-gugudata-api-identity": "bazi-relationship-insight",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                        "operationId": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "pollingUrl": {
                          "type": "string"
                        },
                        "expiresAt": {
                          "type": "string"
                        },
                        "result": {
                          "type": "object",
                          "properties": {}
                        }
                      },
                      "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": "bazi-relationship-insight",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/bazi-relationship-insight",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/ai/pii-removal": {
      "post": {
        "summary": "个人可识别信息(PII) AI 去除",
        "description": "文本隐私信息 AI 脱敏\n接口标签：AI、隐私保护、个人信息保护、AI 模型\n接口特性：\n- 基于自有专业模型进行 PII 自动去除\n- 高效处理敏感信息\n- 围绕“个人可识别信息(PII) AI 去除”提供标准化能力，便于快速接入现有业务\n- 适合将“个人可识别信息(PII) AI 去除”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n- 可与摘要、翻译、关键词和情绪分析等接口组合使用\n- 便于对输入文本进行批量处理、人工复核和结果归档\n详情页：https://www.gugudata.com/api/details/pii-removal",
        "operationId": "post_pii_removal",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/pii-removal"
        },
        "x-gugudata-api-identity": "pii-removal",
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "text": {
                          "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/ai/pii-removal/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": "需要去除个人信息的文本内容"
                  },
                  "streaming": {
                    "type": "boolean",
                    "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "",
                "streaming": false
              }
            }
          }
        }
      }
    },
    "/ai/poet-writing": {
      "post": {
        "summary": "诗歌创作 AI 大师",
        "description": "基于 AI 模型的诗歌创作大师\n接口标签：AI、文本生成、诗歌生成、诗歌创作、文学生成\n接口特性：\n- 支持根据主题生成高质量原创诗歌\n- 自动识别主题内容，生成符合情感和语境的诗歌\n- 多语言支持，可创作不同语言的诗歌\n- 基于 AI 模型，持续优化诗歌生成质量\n- 适用于文学创作、教育启发、文化传播等多个领域\n- 接口极速响应，支持高并发调用\n- 围绕“诗歌创作 AI 大师”提供标准化能力，便于快速接入现有业务\n- 适合将“诗歌创作 AI 大师”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/poet-writing",
        "operationId": "post_poet_writing",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/poet-writing"
        },
        "x-gugudata-api-identity": "poet-writing",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": {
                        "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/ai/poet-writing/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "topic": {
                    "type": "string",
                    "description": "诗歌主题，支持多语言输入，长度不超过 200 个字符"
                  }
                },
                "required": [
                  "topic"
                ]
              },
              "example": {
                "topic": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/sentiment-analysis": {
      "post": {
        "summary": "多语言文本 AI 情感分析",
        "description": "AI 模型快速分析文本情感倾向\n接口标签：AI、文本处理、多语言文本、情感分析\n接口特性：\n- 支持多语言文本情感分析\n- 基于特定 AI 模型，快速识别文本情感倾向\n- 适用于评论分析、舆情监控等场景\n- 围绕“多语言文本 AI 情感分析”提供标准化能力，便于快速接入现有业务\n- 适合将“多语言文本 AI 情感分析”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n- 可与摘要、翻译、关键词和情绪分析等接口组合使用\n详情页：https://www.gugudata.com/api/details/sentiment-analysis",
        "operationId": "post_sentiment_analysis",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/sentiment-analysis"
        },
        "x-gugudata-api-identity": "sentiment-analysis",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "sentiment": {
                          "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/ai/sentiment-analysis/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "textContent": {
                    "type": "string",
                    "description": "需要进行情感分析的文本内容"
                  }
                },
                "required": [
                  "textContent"
                ]
              },
              "example": {
                "textContent": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/stock-financial-report-analysis": {
      "post": {
        "summary": "A 股财报 AI 智能解读",
        "description": "A 股财报智能解读与证据分析\n接口标签：AI、财报、A股、风险信号、AI 财报解读、结构化 JSON、新闻证据\n接口特性：\n- 综合公司资料、行情、财务、资金流和新闻证据生成财报解读\n- 返回数据可用性说明，便于判断本次分析覆盖了哪些信息源\n- 适合财报速读、投研辅助、公告解读和股票详情页智能摘要等场景\n- 分析结果仅供信息参考，不构成任何投资建议\n- 围绕“A 股财报 AI 智能解读”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股财报 AI 智能解读”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stock-financial-report-analysis",
        "operationId": "post_stock_financial_report_analysis",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stock-financial-report-analysis"
        },
        "x-gugudata-api-identity": "stock-financial-report-analysis",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请检查 symbol、startYear 等参数是否完整且格式正确"
          },
          {
            "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": {
                        "stockProfile": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "股票基础资料。"
                        },
                        "marketSnapshot": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "行情快照。"
                        },
                        "financialMetrics": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "核心财务指标。"
                        },
                        "financialStatements": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "财务报表摘要。"
                        },
                        "fundFlow": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "资金流数据摘要。"
                        },
                        "newsEvidence": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          },
                          "description": "相关新闻证据列表。"
                        },
                        "computedSignals": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "根据原始数据计算得到的辅助信号。"
                        },
                        "aiAnalysis": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "AI 生成的财报分析内容。"
                        },
                        "complianceNotice": {
                          "type": "string",
                          "description": "合规提示。"
                        },
                        "dataAvailability": {
                          "type": "object",
                          "additionalProperties": true,
                          "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/ai/stock-financial-report-analysis/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": {
                  "symbol": {
                    "type": "string",
                    "description": "A 股股票代码，支持 6 位代码或带市场前缀代码，例如 600519、sh600519。"
                  },
                  "reportDate": {
                    "type": "string",
                    "description": "财报日期或报告期，建议使用 yyyyMMdd 或 yyyy-MM-dd；为空时按接口默认可用报告期处理。"
                  },
                  "language": {
                    "type": "string",
                    "description": "返回分析语言，例如 zh 或 en。"
                  }
                },
                "required": [
                  "symbol"
                ]
              },
              "example": {
                "symbol": 600519,
                "reportDate": "",
                "language": "zh"
              }
            }
          }
        }
      }
    },
    "/ai/summarize": {
      "post": {
        "summary": "PDF 全文多语言 AI 摘要",
        "description": "PDF 全文多语言智能摘要\n接口标签：AI、PDF、文本摘要、AI 处理、智能摘要\n接口特性：\n- 支持上传 PDF 文件并生成 AI 摘要\n- appKey、lang 和 streaming 通过 query 参数传入，PDF 通过 multipart/form-data 上传\n- lang 可指定摘要语言，适合中文、英文等多语言文档摘要\n- 适合论文、报告、合同、说明书和长文档快速阅读等场景\n- 围绕“PDF 全文多语言 AI 摘要”提供标准化能力，便于快速接入现有业务\n- 适合将“PDF 全文多语言 AI 摘要”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/summarize-pdf",
        "operationId": "post_summarize_pdf",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/summarize-pdf"
        },
        "x-gugudata-api-identity": "summarize-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 无效或未授权"
          }
        ],
        "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": {
                        "summary": {
                          "type": "string",
                          "description": "AI 生成的 PDF 摘要文本。"
                        }
                      },
                      "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/ai/summarize/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "lang",
            "in": "query",
            "required": false,
            "description": "摘要语言，例如 zh、en；为空时使用默认语言。",
            "schema": {
              "type": "string",
              "enum": [
                "zh",
                "en"
              ]
            },
            "example": "zh"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用流式返回，默认 false。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "通过 multipart/form-data 上传的 PDF 文件。"
                  }
                },
                "required": [
                  "file"
                ]
              }
            }
          }
        }
      }
    },
    "/ai/text-summarize": {
      "post": {
        "summary": "文本多语言 AI 摘要",
        "description": "AI 生成文本摘要\n接口标签：AI、文本、AI 处理、智能摘要\n接口特性：\n- 支持多语言摘要生成\n- 支持长文本处理\n- 基于 AI 模型，持续迭代优化\n- 围绕“文本多语言 AI 摘要”提供标准化能力，便于快速接入现有业务\n- 适合将“文本多语言 AI 摘要”结果接入业务系统、后台工具和自动化流程\n- 适合内容生产、文本审核和知识整理等智能处理场景\n- 支持将 AI 处理结果接入审核、编辑和运营流程\n- 可与摘要、翻译、关键词和情绪分析等接口组合使用\n详情页：https://www.gugudata.com/api/details/summarize-text",
        "operationId": "post_summarize_text",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/summarize-text"
        },
        "x-gugudata-api-identity": "summarize-text",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": "接口数据返回时间"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "DataTotalCount": {
                          "description": "本次响应数据总数或分页总数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "summary": {
                          "type": "string",
                          "description": "生成的文本摘要内容，语言通过 lang 参数控制"
                        }
                      },
                      "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/ai/text-summarize/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "lang",
            "in": "query",
            "required": true,
            "description": "摘要语言，常用取值 zh、en。",
            "schema": {
              "type": "string",
              "enum": [
                "zh",
                "en"
              ],
              "default": "zh"
            },
            "example": "zh"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "properties": {
                  "textContent": {
                    "type": "string",
                    "description": "需要生成摘要的文本内容"
                  }
                },
                "required": [
                  "textContent"
                ]
              },
              "example": {
                "textContent": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/traditional-calendar-guidance": {
      "post": {
        "summary": "传统历法宜忌参考",
        "description": "传统历法与时辰的智能参考\n接口标签：传统历法、农历节气、宜忌参考、AI\n接口特性：\n- 按指定公历日期和时辰计算完整传统历法信息\n- 返回农历年月日、年月至日时四柱干支、生肖和星座\n- 提供当日节气、下一个节气及对应公历日期\n- 提供宜忌、生肖冲煞、吉神凶煞和彭祖百忌\n- 补充十二值日、二十八宿、纳音、方位和胎神信息\n- 历法基础字段由确定性规则计算，不被文化解读改写\n- 同时支持同步 JSON、异步任务和 SSE 流式响应\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/traditional-calendar-guidance",
        "operationId": "post_traditional_calendar_guidance",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/traditional-calendar-guidance"
        },
        "x-gugudata-api-identity": "traditional-calendar-guidance",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "Data": {
                      "type": "object",
                      "properties": {
                        "基础数据": {
                          "type": "object",
                          "properties": {
                            "农历日期": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "农历年月日和中文日期。"
                            },
                            "干支": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "年、月、日、时干支。"
                            },
                            "节气": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "当日和下一个节气。"
                            },
                            "宜": {
                              "type": "array",
                              "items": {
                                "type": "object"
                              },
                              "description": "传统历法宜项。"
                            },
                            "忌": {
                              "type": "array",
                              "items": {
                                "type": "object"
                              },
                              "description": "传统历法忌项。"
                            }
                          },
                          "description": "农历年月日和中文日期。"
                        },
                        "文化解读": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "日程安排参考。"
                        }
                      },
                      "description": "日程安排参考。"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "咕咕数据标准响应结构。"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "description": "streaming=true 时返回 SSE 事件流，完成事件为 [DONE]。"
              }
            }
          },
          "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/ai/traditional-calendar-guidance/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。",
            "schema": {
              "type": "boolean",
              "enum": [
                "false",
                "true"
              ]
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string",
                    "description": "需要查询的公历日期，严格使用 YYYY-MM-DD 格式。"
                  },
                  "time": {
                    "type": "string",
                    "description": "需要查询的具体时间，使用 HH:mm 或 HH:mm:ss 的 24 小时制格式；不传时按中午 12:00 计算。"
                  },
                  "timezone": {
                    "type": "string",
                    "description": "日期与时辰使用的时区，当前固定支持 Asia/Shanghai。"
                  },
                  "language": {
                    "type": "string",
                    "description": "输出语言，支持 zh-CN、zh-TW、en-US。"
                  }
                },
                "required": [
                  "date"
                ]
              },
              "example": {
                "date": "2026-07-10",
                "time": "12:00",
                "timezone": "Asia/Shanghai",
                "language": "zh-CN"
              }
            }
          }
        }
      }
    },
    "/ai/v1/articles/extract": {
      "post": {
        "summary": "文章抽取信息化 JSON",
        "description": "文章信息结构化抽取\n接口标签：网页处理、LLM、内容提取、网页解析\n接口特性：\n- 支持从任意网页 URL 提取干净的文章内容\n- 自动去除广告、导航栏和非内容元素\n- 提取文章标题、内容、作者和发布日期\n- 支持自定义解析器和获取选项\n- 提供独立的 HTML 字符串提取接口（/ai/v1/articles/extractFromHtml）\n- 支持直接从 HTML 字符串提取\n- 高质量的内容提取，智能解析\n- 围绕“文章抽取信息化 JSON”提供标准化能力，便于快速接入现有业务\n详情页：https://www.gugudata.com/api/details/article-extract",
        "operationId": "post_article_extract",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/article-extract"
        },
        "x-gugudata-api-identity": "article-extract",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "文章成功提取"
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "无效或缺少必需参数（url 参数是必需的）"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "103",
            "title": "账号欠费",
            "remark": ""
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "110",
            "title": "接口响应错误",
            "remark": "文章提取过程中发生内部服务器错误。URL 可能无法访问或内容格式可能不受支持"
          }
        ],
        "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"
                        },
                        "title": {
                          "type": "string",
                          "description": "提取的文章标题"
                        },
                        "description": {
                          "type": "string",
                          "description": "文章描述/摘要"
                        },
                        "links": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "文章中包含的链接数组"
                        },
                        "image": {
                          "type": "string",
                          "description": "文章主图片 URL"
                        },
                        "content": {
                          "type": "string",
                          "description": "提取的文章内容（HTML 格式，已去除广告和导航栏）"
                        },
                        "author": {
                          "type": "string",
                          "description": "文章作者（如果可用，可能为空字符串）"
                        },
                        "favicon": {
                          "type": "string",
                          "description": "网站图标 URL"
                        },
                        "source": {
                          "type": "string",
                          "description": "来源网站域名（如 sohu.com）"
                        },
                        "published": {
                          "type": "string",
                          "description": "文章发布日期/时间（格式：YYYY-MM-DD HH:MM）"
                        },
                        "ttr": {
                          "type": "integer",
                          "format": "int32",
                          "description": "预计阅读时间（Time to Read，单位：分钟）"
                        },
                        "type": {
                          "type": "string",
                          "description": "文章类型（如 news、article 等）"
                        }
                      },
                      "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/ai/v1/articles/extract/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": "需要提取文章内容的网页 URL 地址"
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "N/A"
              }
            }
          }
        }
      }
    },
    "/ai/v1/articles/extractFromHtml": {
      "post": {
        "summary": "从 HTML 提取文章内容",
        "description": "从已获取的 HTML 内容中提取文章标题、正文、摘要和站点信息。\n接口标签：网页处理、LLM、内容提取、网页解析\n详情页：https://www.gugudata.com/api/details/article-extract",
        "operationId": "post_post_ai_v1_articles_extractfromhtml",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/article-extract"
        },
        "x-gugudata-api-identity": "article-extract",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "文章成功提取"
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "无效或缺少必需参数（url 参数是必需的）"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "103",
            "title": "账号欠费",
            "remark": ""
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "110",
            "title": "接口响应错误",
            "remark": "文章提取过程中发生内部服务器错误。URL 可能无法访问或内容格式可能不受支持"
          }
        ],
        "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": {
                        "title": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        },
                        "excerpt": {
                          "type": "string"
                        },
                        "byline": {
                          "type": "string"
                        },
                        "siteName": {
                          "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": "article-extract",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/article-extract",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "html": {
                    "type": "string",
                    "description": "待解析的 HTML 字符串。"
                  },
                  "url": {
                    "type": "string",
                    "description": "可选的原始文章 URL，用于辅助解析相对链接。"
                  },
                  "parserOptions": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "可选的解析配置。"
                  }
                },
                "required": [
                  "html"
                ]
              },
              "example": {
                "html": "",
                "url": "",
                "parserOptions": {}
              }
            }
          }
        }
      }
    },
    "/ai/western-zodiac-period-insight": {
      "post": {
        "summary": "星座周期趋势解读",
        "description": "星座周期趋势的智能解读\n接口标签：星座、周期趋势、文化娱乐、AI\n接口特性：\n- 支持中文、英文星座名称或通过出生日期自动换算\n- 严格校验星座与出生日期二选一，避免输入含义冲突\n- 覆盖今日、明日、本周、本月和本年五种周期\n- 周期起止标识按北京时间和目标日期自动规范化\n- 星座归属由本地日期边界规则计算，不受文化解读影响\n- 提供周期主题、事业学习、关系沟通和生活提醒\n- 同时支持同步 JSON、异步任务和 SSE 流式响应\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n详情页：https://www.gugudata.com/api/details/western-zodiac-period-insight",
        "operationId": "post_western_zodiac_period_insight",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/western-zodiac-period-insight"
        },
        "x-gugudata-api-identity": "western-zodiac-period-insight",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "Data": {
                      "type": "object",
                      "properties": {
                        "基础数据": {
                          "type": "object",
                          "properties": {
                            "星座": {
                              "type": "string",
                              "description": "规范化星座。"
                            },
                            "周期标识": {
                              "type": "string",
                              "description": "本次结果对应的周期。"
                            }
                          }
                        },
                        "文化解读": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "周期主题、方向分析与提醒。"
                        }
                      },
                      "description": "周期主题、方向分析与提醒。"
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "咕咕数据标准响应结构。"
                }
              },
              "text/event-stream": {
                "schema": {
                  "type": "string"
                },
                "description": "streaming=true 时返回 SSE 事件流，完成事件为 [DONE]。"
              }
            }
          },
          "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/ai/western-zodiac-period-insight/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "responseMode",
            "in": "query",
            "required": false,
            "description": "响应模式：sync 同步返回结果；task 创建异步任务并返回 operationId。",
            "schema": {
              "type": "string",
              "enum": [
                "sync",
                "task"
              ]
            },
            "example": "sync"
          },
          {
            "name": "streaming",
            "in": "query",
            "required": false,
            "description": "是否使用 SSE 流式响应。true 仅支持 responseMode=sync，不能与 task 同时使用。",
            "schema": {
              "type": "boolean",
              "enum": [
                "false",
                "true"
              ]
            },
            "example": false
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sign": {
                    "type": "string",
                    "description": "十二星座中文或英文名称，例如巨蟹座、cancer；与 birthDate 必须且只能传一个。"
                  },
                  "birthDate": {
                    "type": "string",
                    "description": "出生日期，使用 YYYY-MM-DD 格式，系统会按日期边界换算星座；与 sign 必须且只能传一个。"
                  },
                  "period": {
                    "type": "string",
                    "description": "解读周期：today 今日、tomorrow 明日、week 本周、month 本月、year 本年。"
                  },
                  "targetDate": {
                    "type": "string",
                    "description": "周期计算基准日期，使用 YYYY-MM-DD 格式；不传时默认为北京时间当天。"
                  },
                  "language": {
                    "type": "string",
                    "description": "输出语言，支持 zh-CN、zh-TW、en-US。"
                  }
                }
              },
              "example": {
                "sign": "巨蟹座",
                "birthDate": "N/A",
                "period": "today",
                "targetDate": "N/A",
                "language": "zh-CN"
              }
            }
          }
        }
      }
    },
    "/ai/ziwei-fortune": {
      "post": {
        "summary": "紫微星斗大师",
        "description": "自有紫微模型训练的命盘洞察\n接口标签：自研命理模型、紫微命盘、传统文化、AI\n接口特性：\n- 基于自研命理推演模型与专有训练优化策略，提供高精度紫微命盘推演与解读\n- 支持结构化出生信息输入，便于业务系统与自动化流程稳定接入\n- 覆盖十二宫位、主辅星、四化、大限与流年趋势等核心解读结果\n- 输出面向产品消费的结构化 JSON，适合前端展示、报告生成与会员服务场景\n- 智能提炼事业、财运、感情、健康等方向的重点建议，便于用户快速理解\n- 结果用于传统文化研究与娱乐参考，不作为现实决策依据\n- 支持 responseMode=task 任务模式，先返回 operationId，再通过轮询接口查询结果\n- 围绕“紫微星斗大师”提供标准化能力，便于快速接入现有业务\n详情页：https://www.gugudata.com/api/details/ziwei-fortune",
        "operationId": "post_ziwei_fortune",
        "tags": [
          "国学与命理接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/ziwei-fortune"
        },
        "x-gugudata-api-identity": "ziwei-fortune",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "请求参数不完整或无效"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "APPKEY 无效或未授权"
          }
        ],
        "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": {
                        "基本信息": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "命盘推演所使用的基础出生信息"
                        },
                        "命盘摘要": {
                          "type": "string",
                          "description": "对整体命格与人生节奏的综合概述"
                        },
                        "十二宫位": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "命宫、财帛宫、事业宫等十二宫位的解读"
                        },
                        "主星与辅星": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "主星格局与辅星亮点分析"
                        },
                        "四化分析": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "化禄、化权、化科、化忌的推演结果"
                        },
                        "大限": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "分阶段的大限主题与趋势解读"
                        },
                        "流年趋势": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "近一年、近三年的趋势变化与提醒"
                        },
                        "综合建议": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "事业、财运、感情、健康等方向的综合建议"
                        },
                        "operationId": {
                          "type": "string",
                          "description": "仅 responseMode=task 时返回，任务唯一标识。"
                        },
                        "status": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，状态枚举：PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。"
                        },
                        "pollingUrl": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，任务状态查询地址。"
                        },
                        "expiresAt": {
                          "type": "string",
                          "description": "仅 responseMode=task 或轮询接口返回，任务结果过期时间。"
                        },
                        "result": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "仅任务状态为 SUCCEEDED 时返回，业务结果结构与同步模式一致。"
                        },
                        "error": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "仅任务状态为 FAILED 时返回，失败原因信息。"
                        }
                      },
                      "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/ai/ziwei-fortune/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": {
                  "gender": {
                    "type": "string",
                    "description": "性别，如：男、女。"
                  },
                  "calendarType": {
                    "type": "string",
                    "description": "历法类型，如：公历、农历。"
                  },
                  "birthDate": {
                    "type": "string",
                    "description": "出生日期，格式：YYYY-MM-DD。"
                  },
                  "birthTime": {
                    "type": "string",
                    "description": "出生时间，格式：HH:MM。"
                  },
                  "birthPlace": {
                    "type": "string",
                    "description": "出生地点，用于命盘推演时结合地域信息进行解读。"
                  },
                  "isLeapMonth": {
                    "type": "boolean",
                    "description": "农历出生时是否为闰月，公历场景可保持 false。"
                  },
                  "streaming": {
                    "type": "boolean",
                    "description": "是否流式响应，如果为 true，那么接口会流式输出纯文本，在最后一个消息输出完整结果的 JSON。当 responseMode=task 时，streaming 必须为 false。"
                  },
                  "responseMode": {
                    "type": "string",
                    "description": "响应模式，可选值：sync、task。为 task 时立即返回任务受理结果，不阻塞等待模型完成。",
                    "enum": [
                      "sync",
                      "task"
                    ]
                  }
                },
                "required": [
                  "gender",
                  "calendarType",
                  "birthDate",
                  "birthTime",
                  "birthPlace"
                ]
              },
              "example": {
                "gender": "",
                "calendarType": "",
                "birthDate": "N/A",
                "birthTime": "N/A",
                "birthPlace": "N/A",
                "isLeapMonth": false,
                "streaming": false,
                "responseMode": "sync"
              }
            }
          }
        }
      }
    },
    "/barcode/barcode": {
      "get": {
        "summary": "通用条形码生成",
        "description": "通用条形码生成接口\n接口标签：网络工具、条码、条形码、支持40种条形码、自定义尺寸\n接口特性：\n- 支持 40 种条形码\n- 支持生成自定义的条码尺寸\n- 直接生成条码图片 CDN 链接，方便引用\n- 围绕“通用条形码生成”提供标准化能力，便于快速接入现有业务\n- 适合将“通用条形码生成”结果接入业务系统、后台工具和自动化流程\n- 适合线下物料、包装标签和业务凭证管理场景\n- 可用于营销活动、设备配网、资产标识和表单入口管理\n- 支持将生成或解析结果接入网页、管理后台和自动化流程\n详情页：https://www.gugudata.com/api/details/barcode",
        "operationId": "get_barcode",
        "tags": [
          "条码与二维码接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/barcode"
        },
        "x-gugudata-api-identity": "barcode",
        "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": {
                        "Content": {
                          "type": "string",
                          "description": "条形码类型:条形码内容"
                        },
                        "Url": {
                          "type": "string",
                          "description": "生成的条形码 CDN 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/barcode/barcode/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "description": "条码类型，可选项: UNSPECIFIED|UPCA|UPCE|UPC_SUPPLEMENTAL_2DIGIT|UPC_SUPPLEMENTAL_5DIGIT|EAN13|EAN8|Interleaved2of5|Interleaved2of5_Mod10|Standard2of5|Standard2of5_Mod10|Industrial2of5|Industrial2of5_Mod10|CODE39|CODE39Extended|CODE39_Mod43|Codabar|PostNet|BOOKLAND|ISBN|JAN13|MSI_Mod10|MSI_2Mod10|MSI_Mod11|MSI_Mod11_Mod10|Modified_Plessey|CODE11|USD8|UCC12|UCC13|LOGMARS|CODE128|CODE128A|CODE128B|CODE128C|ITF14|CODE93|TELEPEN|FIM|PHARMACODE",
            "schema": {
              "type": "string",
              "enum": [
                "UNSPECIFIED",
                "UPCA",
                "UPCE",
                "UPC_SUPPLEMENTAL_2DIGIT",
                "UPC_SUPPLEMENTAL_5DIGIT",
                "EAN13",
                "EAN8",
                "Interleaved2of5",
                "Interleaved2of5_Mod10",
                "Standard2of5",
                "Standard2of5_Mod10",
                "Industrial2of5",
                "Industrial2of5_Mod10",
                "CODE39",
                "CODE39Extended",
                "CODE39_Mod43",
                "Codabar",
                "PostNet",
                "BOOKLAND",
                "ISBN",
                "JAN13",
                "MSI_Mod10",
                "MSI_2Mod10",
                "MSI_Mod11",
                "MSI_Mod11_Mod10",
                "Modified_Plessey",
                "CODE11",
                "USD8",
                "UCC12",
                "UCC13",
                "LOGMARS",
                "CODE128",
                "CODE128A",
                "CODE128B",
                "CODE128C",
                "ITF14",
                "CODE93",
                "TELEPEN",
                "FIM",
                "PHARMACODE"
              ]
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "content",
            "in": "query",
            "required": true,
            "description": "条码内容，注意对应条码的长度规范",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "width",
            "in": "query",
            "required": true,
            "description": "条码宽度像素值",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "height",
            "in": "query",
            "required": true,
            "description": "条码高度像素值",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "showLabel",
            "in": "query",
            "required": false,
            "description": "控制是否显示条码底部的文字标签，默认不显示，需要显示传递 true",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ]
      }
    },
    "/barcode/qrcode": {
      "get": {
        "summary": "通用二维码生成",
        "description": "提供通用的二维码生成接口\n接口标签：网络工具、条码、二维码、中英文字符、智能识别网页地址\n接口特性：\n- 支持分类字符生成\n- 直接返回存储在 CDN 中的二维码链接，可直接使用\n- 网址内容直接识别，生成网址类型的二维码，扫描后可直接跳转\n- 自定义二维码尺寸\n- 围绕“通用二维码生成”提供标准化能力，便于快速接入现有业务\n- 适合将“通用二维码生成”结果接入业务系统、后台工具和自动化流程\n- 适合线下物料、包装标签和业务凭证管理场景\n- 可用于营销活动、设备配网、资产标识和表单入口管理\n详情页：https://www.gugudata.com/api/details/qrcode",
        "operationId": "get_qrcode",
        "tags": [
          "条码与二维码接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/qrcode"
        },
        "x-gugudata-api-identity": "qrcode",
        "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": {
                        "Content": {
                          "type": "string",
                          "description": "二维码内容"
                        },
                        "Url": {
                          "type": "string",
                          "description": "生成的二维码 CDN 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/barcode/qrcode/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "content",
            "in": "query",
            "required": true,
            "description": "二维码内容，网址类型智能识别",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "正整数，二维码尺寸像素，默认为 500 像素",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 500
          }
        ]
      }
    },
    "/barcode/qrcode/decode": {
      "post": {
        "summary": "通用二维码解析读取",
        "description": "提供通用的二维码解码接口\n接口标签：网络工具、条码、二维码、二维码解码、支持多种字段属性\n接口特性：\n- 支持多种格式的二维码解码\n- 返回解析后的内容和二维码在图像中的位置\n- 围绕“通用二维码解析读取”提供标准化能力，便于快速接入现有业务\n- 适合将“通用二维码解析读取”结果接入业务系统、后台工具和自动化流程\n- 适合线下物料、包装标签和业务凭证管理场景\n- 可用于营销活动、设备配网、资产标识和表单入口管理\n- 支持将生成或解析结果接入网页、管理后台和自动化流程\n- 便于二维码、条形码和业务对象之间建立可追溯关联\n详情页：https://www.gugudata.com/api/details/qrcode-decode",
        "operationId": "post_qrcode_decode",
        "tags": [
          "条码与二维码接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/qrcode-decode"
        },
        "x-gugudata-api-identity": "qrcode-decode",
        "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": {
                        "Format": {
                          "type": "string",
                          "description": "二维码的格式"
                        },
                        "Parsed": {
                          "type": "string",
                          "description": "解析后的内容"
                        },
                        "Points": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "二维码在图像中的坐标点"
                        },
                        "Raw": {
                          "type": "string",
                          "description": "原始内容"
                        },
                        "Type": {
                          "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/barcode/qrcode/decode/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": "要解码的二维码图片文件"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "YOUR_FILE"
              }
            }
          }
        }
      }
    },
    "/barcode/wifiqrcode": {
      "get": {
        "summary": "Wi-Fi 无线网二维码生成",
        "description": "Wi-Fi 无线网二维码生成接口\n接口标签：网络工具、条码、二维码、兼容多种协议、支持添加图标\n接口特性：\n- 兼容多种无线网协议\n- 支持是否隐藏 Wi-Fi SSID\n- 支持是否在二维码中间添加 Wi-Fi 图标，更加美观\n- 自定义二维码尺寸\n- 围绕“Wi-Fi 无线网二维码生成”提供标准化能力，便于快速接入现有业务\n- 适合将“Wi-Fi 无线网二维码生成”结果接入业务系统、后台工具和自动化流程\n- 适合线下物料、包装标签和业务凭证管理场景\n- 可用于营销活动、设备配网、资产标识和表单入口管理\n详情页：https://www.gugudata.com/api/details/wifiqrcode",
        "operationId": "get_wifiqrcode",
        "tags": [
          "条码与二维码接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/wifiqrcode"
        },
        "x-gugudata-api-identity": "wifiqrcode",
        "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": {
                        "Content": {
                          "type": "string",
                          "description": "Wi-Fi SSID"
                        },
                        "Url": {
                          "type": "string",
                          "description": "生成的二维码 CDN 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/barcode/wifiqrcode/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "ssid",
            "in": "query",
            "required": true,
            "description": "无线网 ssid",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "password",
            "in": "query",
            "required": true,
            "description": "无线网密码",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "authentication",
            "in": "query",
            "required": true,
            "description": "无线网加密类型，可选 WEP、WPA、NOPASS",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "ishiddenssid",
            "in": "query",
            "required": true,
            "description": "是否隐藏 SSID，可选值 true、false",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "isshowwifiicon",
            "in": "query",
            "required": true,
            "description": "二维码中间是否添加 Wi-Fi 图标，可选值 true、false",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ]
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "size",
            "in": "query",
            "required": false,
            "description": "正整数，二维码尺寸像素，默认为 500 像素",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 500
          }
        ]
      }
    },
    "/college/global-university": {
      "get": {
        "summary": "全球大学基础信息数据",
        "description": "全球高校基础信息以及专业摘要数据查询\n接口标签：QS排名、世界大学、国际教育、全球大学信息\n接口特性：\n- 近 7000 所世界大学最新基础数据\n- 提供全球顶尖大学详细排名信息\n- 每半个月人工手动定时更新数据\n- 包含大学基本信息、地理位置、官方网站等数据\n- 支持按国家、地区、城市多维度筛选\n- 支持模糊搜索和多字段排序\n- 数据与咕咕数据平台其他高校接口完全兼容\n- 返回每所大学可用专业数量，并内嵌最多 20 条专业摘要\n- 毫秒级响应性能\n详情页：https://www.gugudata.com/api/details/global-university",
        "operationId": "get_global_university",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/global-university"
        },
        "x-gugudata-api-identity": "global-university",
        "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": {
                        "Rank": {
                          "type": "integer",
                          "format": "int32",
                          "description": "QS 世界大学排名"
                        },
                        "UniversityName": {
                          "type": "string",
                          "description": "大学名称"
                        },
                        "UniversityChineseName": {
                          "type": "string",
                          "description": "大学中文名称（中文翻译供参考，以英文为准）"
                        },
                        "Country": {
                          "type": "string",
                          "description": "大学所在国家"
                        },
                        "Region": {
                          "type": "string",
                          "description": "大学所在地区"
                        },
                        "City": {
                          "type": "string",
                          "description": "大学所在城市"
                        },
                        "Logo": {
                          "type": "string",
                          "description": "大学校徽图片 URL"
                        },
                        "InternationalStudents": {
                          "type": "integer",
                          "format": "int32",
                          "description": "国际生数量"
                        },
                        "SubjectCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "学科数量"
                        },
                        "Website": {
                          "type": "string",
                          "description": "大学官方网站"
                        },
                        "SchoolUUID": {
                          "type": "string",
                          "description": "咕咕数据平台大学唯一 ID，可用于查询该大学专业明细。"
                        },
                        "InstitutionType": {
                          "type": "string",
                          "description": "学校性质，可能值为公办或私立；暂未覆盖时返回空字符串。"
                        },
                        "ProgrammeCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "该大学可查询的专业总数；没有专业明细时返回 0。"
                        },
                        "ProgrammeDataAvailable": {
                          "type": "boolean",
                          "description": "是否存在可查询的专业明细数据。"
                        },
                        "Programmes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "ProgrammeId": {
                                "type": "string",
                                "description": "专业唯一 ID。"
                              },
                              "ProgrammeName": {
                                "type": "string",
                                "description": "专业名称。"
                              },
                              "StudyLevel": {
                                "type": "string",
                                "description": "学习层级，例如 Undergraduate、Postgraduate、PhD、MBA。"
                              }
                            }
                          },
                          "description": "当前大学内嵌的专业摘要列表，最多返回 20 条；完整专业列表请使用关联接口分页查询。"
                        }
                      },
                      "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/college/global-university/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "description": "搜索关键字，模糊匹配大学名称或大学中文名称进行模糊匹配，参数值为空则返回所有数据",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "按国家筛选，支持模糊匹配，参数值为空则不进行筛选",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "region",
            "in": "query",
            "required": false,
            "description": "按地区筛选，支持模糊匹配，参数值为空则不进行筛选",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "required": false,
            "description": "按城市筛选，支持模糊匹配，参数值为空则不进行筛选",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "排序方式，支持的排序字段：rank（排名）、title（大学名称），排序方向：asc（升序）、desc（降序）。格式：字段名|排序方向",
            "schema": {
              "type": "string"
            },
            "example": "rank|asc"
          },
          {
            "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
          }
        ]
      }
    },
    "/college/global-university-programmes": {
      "get": {
        "summary": "学校专业明细分页查询",
        "description": "根据全球大学基础信息接口返回的 SchoolUUID，分页查询该大学下的完整专业列表。\n接口标签：QS排名、世界大学、国际教育、全球大学信息\n详情页：https://www.gugudata.com/api/details/global-university",
        "operationId": "get_get_college_global_university_programmes",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/global-university"
        },
        "x-gugudata-api-identity": "global-university",
        "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": "业务状态说明。"
                        },
                        "DataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "本次响应数据总数或分页总数。"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        },
                        "ResponseDateTime": {
                          "description": "接口响应时间。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "ProgrammeId": {
                            "type": "string"
                          },
                          "ProgrammeName": {
                            "type": "string"
                          },
                          "StudyLevel": {
                            "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": "global-university",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/global-university",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "schoolUuid",
            "in": "query",
            "required": true,
            "description": "全球大学基础信息接口返回的 SchoolUUID。",
            "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": "每页数据量，默认值为 20，最大值为 100。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          }
        ]
      }
    },
    "/education/exam-question-similarity": {
      "post": {
        "summary": "考题相似度 AI 分析",
        "description": "考题语义相似度与解析评估\n接口标签：AI、教育、考题分析、专有 AI 模型、包含评估详情\n接口特性：\n- 支持按题干、答案、解析、知识点和解题路径综合判断考题相似度\n- score 使用 0 到 1 区间，适合用于重复题检测、题库清洗和近似题推荐\n- exam1 与 exam2 建议使用一致的 JSON 字段结构，输入信息越完整，分析越稳定\n- 适合教研题库去重、试卷组卷质检、相似题召回和内容审核等场景\n- 围绕“考题相似度 AI 分析”提供标准化能力，便于快速接入现有业务\n- 适合将“考题相似度 AI 分析”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/exam-question-similarity",
        "operationId": "post_exam_question_similarity",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/exam-question-similarity"
        },
        "x-gugudata-api-identity": "exam-question-similarity",
        "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": {
                        "score": {
                          "type": "number",
                          "description": "相似度分数，范围 0 到 1；数值越接近 1，相似度越高。"
                        },
                        "analysis_result": {
                          "type": "string",
                          "description": "AI 生成的相似度分析结论，说明主要相同点、差异点和判断依据。"
                        }
                      },
                      "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/education/exam-question-similarity/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": {
                  "exam1": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "第一道考题对象，建议包含题干、选项、答案、解析、学科、年级、知识点等信息。"
                  },
                  "exam2": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "第二道考题对象，字段结构建议与 exam1 保持一致，用于与 exam1 进行相似度比较。"
                  }
                },
                "required": [
                  "exam1",
                  "exam2"
                ]
              },
              "example": {
                "exam1": {},
                "exam2": {}
              }
            }
          }
        }
      }
    },
    "/fund/basic/index": {
      "get": {
        "summary": "指数基金业绩",
        "description": "指数基金收益、费率与跟踪信息\n接口标签：指数基金、区间收益、跟踪信息、基金业绩、跟踪标的\n接口特性：\n- 按指数类别和指数基金类型筛选当前可用的指数基金业绩快照\n- 返回最新单位净值、净值日期和日增长率，用于查看基金最近表现\n- 覆盖近 1 周、近 1 月、近 3 月、近 6 月、近 1 年及更长周期收益\n- 同时提供今年以来和成立以来收益率，便于比较短期与长期业绩\n- 返回基金费率和最低购买金额，可用于产品列表和购买门槛展示\n- 返回跟踪标的和跟踪方式，用于区分不同指数及被动、增强跟踪策略\n- index 和 indicator 均使用固定中文枚举，参数不在支持范围时返回明确错误\n- 本接口是最新日度业绩快照，不返回盘中成交价格、成交量或分钟行情\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": "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": "指数基金名称，用于识别基金份额和跟踪产品"
                        },
                        "NetAssetValue": {
                          "type": "number",
                          "description": "基金公司最近一次公布的单位净值"
                        },
                        "TimeKey": {
                          "type": "string",
                          "description": "最近单位净值对应的日期，通常格式为 yyyy-MM-dd"
                        },
                        "DayGrowthRate": {
                          "type": "number",
                          "description": "最近单位净值相对上一净值日的增长率，单位为百分比"
                        },
                        "WeekGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 1 周收益率，单位为百分比"
                        },
                        "MonthGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 1 月收益率，单位为百分比"
                        },
                        "ThreeMonthGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 3 月收益率，单位为百分比"
                        },
                        "SixMonthGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 6 月收益率，单位为百分比"
                        },
                        "YearGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 1 年收益率，单位为百分比"
                        },
                        "TwoYearGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 2 年收益率，单位为百分比"
                        },
                        "ThreeYearGrowthRate": {
                          "type": "number",
                          "description": "截至 TimeKey 的近 3 年收益率，单位为百分比"
                        },
                        "ThisYearGrowthRate": {
                          "type": "number",
                          "description": "从本年度首个净值日至 TimeKey 的收益率，单位为百分比"
                        },
                        "SinceEstablishmentGrowthRate": {
                          "type": "number",
                          "description": "从基金成立日至 TimeKey 的累计收益率，单位为百分比"
                        },
                        "Fee": {
                          "type": "number",
                          "description": "数据源提供的基金费率数值，具体计费以基金销售规则为准"
                        },
                        "MinPurchaseAmount": {
                          "type": "string",
                          "description": "基金最低购买金额说明，可能包含金额单位或文字条件"
                        },
                        "TrackingTarget": {
                          "type": "string",
                          "description": "基金主要跟踪的指数或标的名称"
                        },
                        "TrackingMethod": {
                          "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/basic/index/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "index",
            "in": "query",
            "required": true,
            "description": "必填。指数类别，仅支持：全部、沪深指数、行业主题、大盘指数、中盘指数、小盘指数、股票指数、债券指数；必须传完整中文名称",
            "schema": {
              "type": "string"
            },
            "example": "沪深指数"
          },
          {
            "name": "indicator",
            "in": "query",
            "required": true,
            "description": "必填。指数基金类型，仅支持：全部、被动指数型、增强指数型；必须传完整中文名称",
            "schema": {
              "type": "string"
            },
            "example": "被动指数型"
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/fund/fund-etf-open-ranking-list": {
      "get": {
        "summary": "场内基金业绩排行",
        "description": "场内基金多周期收益排行快照\n接口标签：场内基金、ETF 排行、区间收益、ETF、基金排行\n接口特性：\n- 返回当前可用场内基金的最新日度业绩排行快照，无需业务筛选参数\n- 每条记录包含单位净值、累计净值和排行快照日期，便于确认业绩统计时点\n- 覆盖近 1 周、近 1 月、近 3 月、近 6 月和近 1 年收益率\n- 同时提供近 2 年、近 3 年、今年以来和成立以来收益率\n- 返回基金类型和成立日期，可用于排行结果的二次分组与展示\n- DataTotalCount 表示当前可用排行记录总数，正式接口不限制为演示页数量\n- 接口无分页参数，返回规模随当前可用场内基金数量变化\n- 排行依据为基金净值区间收益，不是盘中成交价格、涨跌幅或成交量排行\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": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "FundCode": {
                          "type": "string",
                          "description": "场内基金的 6 位代码，保留前导零"
                        },
                        "FundName": {
                          "type": "string",
                          "description": "场内基金简称，用于排行列表展示"
                        },
                        "FundType": {
                          "type": "string",
                          "description": "基金所属类型，用于区分不同场内基金类别"
                        },
                        "DateKey": {
                          "type": "string",
                          "description": "本条业绩排行快照对应的净值日期，通常格式为 yyyy-MM-dd"
                        },
                        "UnitNetValue": {
                          "type": "number",
                          "description": "基金在 DateKey 最近公布的单位净值"
                        },
                        "AccumulatedNetValue": {
                          "type": "number",
                          "description": "基金在 DateKey 最近公布的累计净值"
                        },
                        "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": "基金成立日期，通常格式为 yyyy-MM-dd"
                        }
                      },
                      "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-etf-open-ranking-list/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/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": "指数型"
          }
        ]
      }
    },
    "/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": "盘中估算净值相对上一净值日的估算涨跌率，单位为百分比"
                        },
                        "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；数据源未提供时可能为空"
                        },
                        "DataScope": {
                          "type": "string",
                          "description": "当前估算结果适用的基金覆盖范围说明"
                        },
                        "NoDataReason": {
                          "type": "string",
                          "description": "有估算数据时通常为空；无匹配结果时具体原因通过 DataStatus.StatusDescription 返回"
                        }
                      },
                      "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"
            }
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/fund/historyminute": {
      "get": {
        "summary": "场内基金分时行情",
        "description": "1 至 60 分钟价格、成交量与成交额\n接口标签：场内基金、分钟行情、成交量、ETF、分时行情\n接口特性：\n- 返回每个分钟周期的开盘价、收盘价、最高价和最低价，可直接绘制分时或 K 线图\n- 同时返回周期成交量、成交额和周期末最新价，用于分析场内交易活跃度\n- period 支持 1、5、15、30、60 分钟，未传时默认使用 5 分钟周期\n- 1 分钟数据的历史覆盖通常短于其他周期，具体可用范围以返回结果为准\n- symbol 支持标准 6 位基金代码，也兼容 sh 或 sz 市场前缀，返回时统一为 6 位代码\n- beginDate 和 endDate 精确到秒，查询间隔最大为 366 个自然日\n- adjust 支持不复权、前复权和后复权，服务端会将大小写统一后处理\n- 日期、代码、周期或复权参数不合法时返回明确参数错误，不会静默改用其他条件\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",
        "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": {
                        "DateTime": {
                          "type": "string",
                          "description": "当前分钟周期对应的行情时间，通常格式为 yyyy-MM-dd HH:mm:ss"
                        },
                        "Symbol": {
                          "type": "string",
                          "description": "当前行情记录所属场内基金的 6 位代码，不包含 sh 或 sz 前缀"
                        },
                        "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": "当前分钟周期内累计成交金额"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "当前分钟周期结束时的最新价；对聚合周期通常与 Close 一致"
                        }
                      },
                      "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/historyminute/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "必填。单个 6 位场内基金代码；也兼容 sh513500 或 sz159915，服务端会去除市场前缀并按标准 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": 513500
          },
          {
            "name": "beginDate",
            "in": "query",
            "required": true,
            "description": "必填。查询开始时间，严格使用 yyyyMMdd HH:mm:ss 格式，例如 20260701 09:30:00",
            "schema": {
              "type": "string"
            },
            "example": "20260701 09:30:00"
          },
          {
            "name": "endDate",
            "in": "query",
            "required": true,
            "description": "必填。查询结束时间，格式与 beginDate 相同；不得早于开始时间，二者间隔最大为 366 个自然日",
            "schema": {
              "type": "string"
            },
            "example": "20260710 15:00:00"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "可选。分钟周期，仅支持 1、5、15、30、60；未传时默认 5",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 5
          },
          {
            "name": "adjust",
            "in": "query",
            "required": false,
            "description": "可选。复权方式：空值表示不复权，pre 表示前复权，after 表示后复权；英文值不区分大小写",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/imagerecognition/imagestreamocr": {
      "post": {
        "summary": "通用图片文件流 OCR 到文本",
        "description": "图片文件流 OCR 文字识别\n接口标签：文件处理、OCR、基于机器学习、精准识别率\n接口特性：\n- 支持 multipart/form-data 图片文件流上传识别\n- imagefile 为图片文件字段，appKey 通过 query 参数传入\n- 返回文本行列表，适合票据、截图、证件、文档图片和普通图片文字抽取\n- 识别结果受图片清晰度、文字方向、遮挡和压缩质量影响\n- 围绕“通用图片文件流 OCR 到文本”提供标准化能力，便于快速接入现有业务\n- 适合将“通用图片文件流 OCR 到文本”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\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": ""
          },
          {
            "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": {
                        "SourceImageUrl": {
                          "type": "string",
                          "description": "上传后用于处理的源图片地址。"
                        },
                        "ResultText": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "OCR 识别出的文本行列表。"
                        }
                      },
                      "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/imagestreamocr/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": {
                  "imagefile": {
                    "type": "string",
                    "format": "binary",
                    "description": "通过 multipart/form-data 上传的图片文件字段，字段名为 imagefile。"
                  }
                },
                "required": [
                  "imagefile"
                ]
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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": "原始图片 URL，如果是 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"
              }
            }
          }
        }
      }
    },
    "/imagerecognition/ocr2word": {
      "post": {
        "summary": "通用图片地址 OCR 到 Word",
        "description": "高可用图像识别引擎\n接口标签：文件处理、OCR、基于机器学习、超精准识别率\n接口特性：\n- 通用的识别接口， 支持多种图片格式\n- 支持中英文字符混合识别\n- 支持 Base64 以及网络地址传参\n- 基于机器学习不断提高的识别率\n- 输出的 Word 文件永久存储\n- 围绕“通用图片地址 OCR 到 Word”提供标准化能力，便于快速接入现有业务\n- 适合将“通用图片地址 OCR 到 Word”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\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": "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": "原始图片 URL，如果是 Base64 格式则不返回"
                        },
                        "ResultWordFileUrl": {
                          "type": "string",
                          "description": "转换后的 Word 文档地址，咕咕数据同时提供永久存储"
                        }
                      },
                      "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/ocr2word/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"
              }
            }
          }
        }
      }
    },
    "/imagerecognition/pdf-splitter": {
      "post": {
        "summary": "PDF 分割拆分",
        "description": "PDF 拆分，支持公开或私有存储\n接口标签：文件处理、PDF、高效处理、安全文件存储\n接口特性：\n- 高效处理大文件\n- 支持多语言字符识别\n- 支持 formdata 格式 PDF 文件流传参\n- 支持设置每个 PDF 文件的页数\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 接口服务多节点部署\n- 围绕“PDF 分割拆分”提供标准化能力，便于快速接入现有业务\n- 适合将“PDF 分割拆分”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/pdfsplitter",
        "operationId": "post_pdfsplitter",
        "tags": [
          "图像与文档转换接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/pdfsplitter"
        },
        "x-gugudata-api-identity": "pdfsplitter",
        "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": {
                        "uuid": {
                          "type": "string",
                          "description": "唯一标识符"
                        },
                        "num_files": {
                          "type": "integer",
                          "format": "int32",
                          "description": "生成的 PDF 文件数量"
                        },
                        "pdf_files": {
                          "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/imagerecognition/pdf-splitter/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": "formdata 文件流"
                  },
                  "storage": {
                    "type": "string",
                    "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "YOUR_VALUE",
                "storage": "public"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/imagerecognition/pdf2html": {
      "post": {
        "summary": "PDF 转 HTML",
        "description": "PDF 转 HTML，支持公开或私有存储\n接口标签：文件处理、PDF、生成HTML站点、安全文件存储\n接口特性：\n- 高效处理大文件\n- 支持多语言字符识别\n- 支持 formdata 格式 PDF 文件流传参\n- 支持公开存储和私有存储，私有模式通过短期下载链接访问\n- 输出可直接访问的 HTML 站点\n- 接口服务多节点部署\n- 围绕“PDF 转 HTML”提供标准化能力，便于快速接入现有业务\n- 适合将“PDF 转 HTML”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/pdf2html",
        "operationId": "post_pdf2html",
        "tags": [
          "图像与文档转换接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "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": {
                        "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/pdf2html/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": "formdata 文件流"
                  },
                  "storage": {
                    "type": "string",
                    "description": "文件存储方式，可选 public 或 private。默认 public 返回公开下载地址；private 存入私有存储，返回 file_id，需生成短期下载链接后下载。"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "YOUR_VALUE",
                "storage": "public"
              }
            }
          }
        }
      }
    },
    "/imagerecognition/pdf2text": {
      "post": {
        "summary": "通用 PDF 文件流 OCR 到文本",
        "description": "高可用图像识别引擎\n接口标签：文件处理、OCR、PDF、基于机器学习、高效文本提取\n接口特性：\n- 通用识别接口\n- 支持中英文等多语言字符混合识别\n- formdata 格式 PDF 文件流传参\n- 基于机器学习不断提高的识别率\n- 输出纯文本内容，适合全文检索或语义分析\n- 围绕“通用 PDF 文件流 OCR 到文本”提供标准化能力，便于快速接入现有业务\n- 适合将“通用 PDF 文件流 OCR 到文本”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n详情页：https://www.gugudata.com/api/details/pdf2text",
        "operationId": "post_pdf2text",
        "tags": [
          "图像与文档转换接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/pdf2text"
        },
        "x-gugudata-api-identity": "pdf2text",
        "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/pdf2text/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 文件流"
                  }
                },
                "required": [
                  "pdffile"
                ]
              },
              "example": {
                "pdffile": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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"
              }
            }
          }
        }
      }
    },
    "/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。需要转换坐标系请调用<a href='https://www.gugudata.com/api/details/coordinateconverter' target='_blank'>地理坐标系转换</a>接口"
                        }
                      },
                      "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
          }
        ]
      }
    },
    "/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": "object",
                      "properties": {
                        "DataId": {
                          "type": "string",
                          "description": "数据全局唯一 ID，仅用于标识数据的唯一"
                        },
                        "SchoolUUID": {
                          "type": "string",
                          "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/ceecollegeline' target='_blank'>历年高考高校录取分数线</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 接口中的 SchoolUUID 进行唯一匹配"
                        },
                        "CollegeName": {
                          "type": "string",
                          "description": "学院名称"
                        },
                        "Province": {
                          "type": "string",
                          "description": "学院所在省份"
                        },
                        "City": {
                          "type": "string",
                          "description": "学院所在城市"
                        },
                        "District": {
                          "type": "string",
                          "description": "学院所在区县"
                        },
                        "Coordinate": {
                          "type": "string",
                          "description": "学院地理坐标经纬度，格式为 [经度,纬度]，地理坐标系为 GCJ-02。需要转换坐标系请调用 <a href='https://www.gugudata.com/api/details/coordinateconverter' target='_blank'>地理坐标系转换</a> 接口"
                        },
                        "CollegeType": {
                          "type": "string",
                          "description": "学院性质，值的枚举: 普通本科|独立学院|专科（高职）|高职高专|中外合作办学|成人教育|HND项目|远程教育学院|其它"
                        },
                        "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": "学院收费（仅供参考）"
                        },
                        "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": "废弃数据标识"
                        }
                      },
                      "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": "学院性质，参数默认值为空，不进行筛选。参数可选枚举值: 普通本科|远程教育学院|中外合作办学||独立学院|高职高专|HND项目|其它|成人教育|专科（高职）",
            "schema": {
              "type": "string",
              "enum": [
                "普通本科",
                "远程教育学院",
                "中外合作办学",
                "独立学院",
                "高职高专",
                "HND项目",
                "其它",
                "成人教育",
                "专科"
              ]
            }
          },
          {
            "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"
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/location/hospital-3a": {
      "get": {
        "summary": "全国三甲医院主体信息",
        "description": "全国三甲医院名录与区域格式化检索\n接口标签：医疗数据、医院名录、主体医院名录、公开基础信息\n接口特性：\n- 支持按医院关键词、省、市、区县组合筛选全国三甲医院\n- 每月定期更新，保持数据新鲜度\n- 返回总数、分页信息和医院主体字段，便于直接构建列表页\n- 适合医疗服务目录、医院检索、地址补全和区域医疗资源分析等场景\n- 分页参数 pageIndex 与 pageSize 用于控制返回范围\n- 围绕“全国三甲医院主体信息”提供标准化能力，便于快速接入现有业务\n- 适合将“全国三甲医院主体信息”结果接入业务系统、后台工具和自动化流程\n- 适合地址解析、区域筛选、机构网点管理和地图类产品接入\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",
                  "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": {
                        "TotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "符合条件的医院总数。"
                        },
                        "PageIndex": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当前页码。"
                        },
                        "PageSize": {
                          "type": "integer",
                          "format": "int32",
                          "description": "每页数量。"
                        },
                        "Items": {
                          "type": "object",
                          "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": "接口返回的业务数据。"
                    }
                  },
                  "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/hospital-3a/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "医院名称或别名关键词，支持模糊搜索。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "province",
            "in": "query",
            "required": false,
            "description": "省份名称，例如 北京、广东。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "city",
            "in": "query",
            "required": false,
            "description": "城市名称，例如 北京市、广州市。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "district",
            "in": "query",
            "required": false,
            "description": "区县名称，例如 海淀区、天河区。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": false,
            "description": "分页页码，从 1 开始。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          }
        ]
      }
    },
    "/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 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 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": "录取批次。枚举值为：专科批|本科二批|本科一批|本科批|本科三批|本科二批A段|本科提前批|本科批A段|本科一批A段|平行录取二段|本科二批B段|国家专项计划本科批|专科批A段|本科二批C段|平行录取一段|本科二批及预科|普通类一段|本科一批B段|本科三批A段|平行录取三段|本科A批|本科一段|本科批B段|本科二批K段|蒙授高职高专|本科一批I段|普通类二段|本科B批|专科提前批|本科提前批A段|地方专项计划本科批|本科二段|本科一批A1段|国家专项计划本科一批|本科一批预科|本科提前批B段|蒙授本科一批|本科提前批（非军检）|蒙授本科二批|普通类提前批|国家专项计划本科二批|地方农村专项计划批|零批次|高校专项计划本科批|本科三批B段|提前专项批|专科批B段|本科综合评价批|高分优先投档批|普通本科批"
                        },
                        "TypeName": {
                          "type": "string",
                          "description": "文科、理科或综合。枚举值为：理科|文科|综合|艺术类|体育类|体育理|蒙授理科|艺术文|体育文|汉授美术|蒙授文科|学考文|学考理|艺术理|汉授音乐|汉授体育|其他艺术|汉授编导|蒙授音乐|蒙授体育|蒙授美术|旅游类|计算机类|3+证书|蒙授其他艺术|农学类|财会类|牧医类|蒙牧医类|美工设计类|汽驾类|幼师类|建筑类|烹饪类"
                        },
                        "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": "查询的录取年份，如 2020、2021、2022、2023、2024、2025。参数默认值为 0：即获取所有年份的录取数据",
            "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": "传递的参数值可选为：3+证书|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|医学类|历史类|学考|学考文|学考理|幼师类|建筑类|文科|旅游类|汉授体育|汉授编导|汉授美术|汉授音乐|汽驾类|烹饪类|牧医类|物理类|理科|综合|美工设计类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|蒙授体育|蒙授其他艺术|蒙授文科|蒙授理科|蒙授美术|蒙授音乐|蒙牧医类|计算机类|财会类",
            "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": "录取批次参数，可使用英文逗号分隔传递多个值。可选枚举值：专科批|专科批A段|专科批B段|专科批F段|专科提前批|专科提前批A段|专科特殊类型批|专科特殊类型批次K段|专项计划批|体育本科提前批|体育类本科批|国家专项计划|国家专项计划本科一批|国家专项计划本科二批|国家专项计划本科批|国家及地方专项、南疆单列、对口援疆计划本科一批次|地方专项计划本科批|地方农村专项计划批|平行录取一段|平行录取三段|平行录取二段|提前一批本科|提前专项批|提前批|提前批A段|提前批B段|提前批第一批本科|提前本科批|普通本科批|普通类一段|普通类二段|普通类平行录取|普通类提前批|本科A批|本科A段|本科B批|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批H段|本科一批I段|本科一批U段|本科一批预科|本科一段|本科三批|本科三批A段|本科三批B段|本科专项计划批|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科批|本科批A段|本科批B段|本科批C段|本科批一段|本科提前批|本科提前批A段|本科提前批B段|本科提前批C|本科提前批C段|本科提前批艺术本科第二批|本科提前批艺术类|本科提前批艺术类A段|本科提前批艺术类第1小批|本科提前批（非军检）|本科第一批提前批|本科综合评价批|本科艺术甲批平行段|第一批|第二批第二段|艺本一批|艺术本科A段|艺术本科批B段|艺术本科提前批|艺术类专科批|艺术类本科A段|艺术类本科批|艺术类本科提前批|艺术类本科提前批B段|艺术类第一批|艺术类（本科二批B段）|蒙授本科一批|蒙授本科二批|蒙授高职高专|零志愿批次|零批次|高分优先投档批|高校专项计划|高校专项计划批次|高校专项计划本科批|高职（专科）批Q段|高职（专科）批R段",
            "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": "学院所属省份筛选，如获取所有江苏省高校的录取分数线，那么该值传递 “江苏” 即可，院校省份枚举：上海|云南|内蒙古|北京|吉林|四川|天津|宁夏|安徽|山东|山西|广东|广西|新疆|江苏|江西|河北|河南|浙江|海南|湖北|湖南|甘肃|福建|西藏|贵州|辽宁|重庆|陕西|青海|香港|黑龙江",
            "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": "招生类型筛选，如：普通类",
            "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 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 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
          }
        ]
      }
    },
    "/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": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": 2025
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": false,
            "description": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": "上海"
          }
        ]
      }
    },
    "/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": "查询的年份，如 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": "科目选择类型，如：物理类、历史类等，需要注意对应的年份和省份下，科目选择类型可能不同",
            "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 时可传；例如：统考成绩排名。",
            "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
          }
        ]
      }
    },
    "/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": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": 2026
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": false,
            "description": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": "上海"
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceecollegeline' target='_blank'>历年高考高校录取分数线</a> 接口中的 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": "录取批次，枚举值为：一类模式本科|专科批|专科批A段|专科批F段|专科提前批|专科提前批B段|专科提前批E段|体育专科提前批|体育本科批|体育本科提前批|体育类专科批|体育类专科提前批|体育类本科批|体育类本科提前批|体育类本科第二批|体育艺术本一U段|体育艺术本二W段|分类招生批|区域专项计划本科批|国家专项计划|国家专项计划本科一批|国家专项计划本科批|国家及地方专项、南疆单列、对口援疆计划本科一批次|国家及地方专项、南疆单列、对口援疆计划本科二批次|地方专项计划批|地方专项计划本科批|地方农村专项计划本科批|少数民族预科班|平行录取一段|平行录取三段|平行录取二段|提前一批本科|提前二批本科|提前批|提前批A段|提前批B段|提前批第一批本科|提前批第二批本科|提前本科批|无批次|普通类一段|普通类二段|普通类平行录取|普通类提前批|本科A批|本科A段|本科B段|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批H段|本科一批I段|本科一批U段|本科一批预科|本科一段|本科三批|本科三批A段|本科专项计划批|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科免费定向批|本科批|本科批A段|本科批B段|本科批C段|本科批一段|本科批平行组|本科提前一批|本科提前批|本科提前批A段|本科提前批B段|本科提前批C|本科提前批C段|本科提前批艺术本科第二批|本科提前批艺术类|本科提前批艺术类A段|本科提前批艺术类第1小批|本科提前批（第2小批）|本科第一批|本科第一批提前批|本科第一阶段|本科第二批|本科第二批提前批|本科综合评价批|本科艺术甲批平行段|特殊类型招生批|第一批|第二批B段|第二批第一段|第二批第二段|艺本一批|艺术本科A段|艺术本科B段|艺术本科二批|艺术本科批A段|艺术本科批B段|艺术本科批C段|艺术本科提前批|艺术本科提前批B段|艺术类专科批|艺术类专科提前批|艺术类本科A段|艺术类本科B段|艺术类本科批|艺术类本科批A段|艺术类本科批B段|艺术类本科提前批|艺术类本科提前批B段|艺术类第一批|艺术类第二批|艺术类第二批B段|艺术类（本科二批B段）|零志愿批次|零批次|高校专项计划|高校专项计划批次|高校专项计划本科批|高职（专科）批R段"
                        },
                        "TypeName": {
                          "type": "string",
                          "description": "专业所属的类型，枚举值为：3+证书|会计类|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|农林类|医学类|历史类|园林类|土建类|学考|学考文|学考理|幼师类|建筑类|护理类|教育类|文科|旅游类|服装设计与工艺类|机械加工类|汉授美术|汉授音乐|汽车类|汽驾类|烹饪类|牧医类|物理类|理科|电子商务类|电子技术类|电气技术类|畜牧兽医类|综合|美工设计类|美术类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|药剂类|蒙授体育|蒙授文科|蒙授理科|蒙牧医类|计算机类|财会类|财经类|音乐类"
                        },
                        "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": "特殊要求。表示语种、性别、体检、收费、中外合作、师范、定向、专项、预科、订单培养等限制或说明。"
                        }
                      },
                      "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": "查询的录取年份，如 2020、2021、2022、2023、2024、2025。参数默认值为 0：即获取所有年份的录取数据",
            "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": "专业所属的录取批次，可使用英文逗号分隔传递多个值，格式为：本科二批,专科批。传递参数可选值为：一类模式本科|专科批|专科批A段|专科批F段|专科提前批|专科提前批B段|专科提前批E段|体育专科提前批|体育本科批|体育本科提前批|体育类专科批|体育类专科提前批|体育类本科批|体育类本科提前批|体育类本科第二批|体育艺术本一U段|体育艺术本二W段|分类招生批|区域专项计划本科批|国家专项计划|国家专项计划本科一批|国家专项计划本科批|国家及地方专项、南疆单列、对口援疆计划本科一批次|国家及地方专项、南疆单列、对口援疆计划本科二批次|地方专项计划批|地方专项计划本科批|地方农村专项计划本科批|少数民族预科班|平行录取一段|平行录取三段|平行录取二段|提前一批本科|提前二批本科|提前批|提前批A段|提前批B段|提前批第一批本科|提前批第二批本科|提前本科批|无批次|普通类一段|普通类二段|普通类平行录取|普通类提前批|本科A批|本科A段|本科B段|本科一批|本科一批A1段|本科一批A段|本科一批B段|本科一批H段|本科一批I段|本科一批U段|本科一批预科|本科一段|本科三批|本科三批A段|本科专项计划批|本科二批|本科二批A段|本科二批B段|本科二批C段|本科二批K段|本科二批及预科|本科二段|本科免费定向批|本科批|本科批A段|本科批B段|本科批C段|本科批一段|本科批平行组|本科提前一批|本科提前批|本科提前批A段|本科提前批B段|本科提前批C|本科提前批C段|本科提前批艺术本科第二批|本科提前批艺术类|本科提前批艺术类A段|本科提前批艺术类第1小批|本科提前批（第2小批）|本科第一批|本科第一批提前批|本科第一阶段|本科第二批|本科第二批提前批|本科综合评价批|本科艺术甲批平行段|特殊类型招生批|第一批|第二批B段|第二批第一段|第二批第二段|艺本一批|艺术本科A段|艺术本科B段|艺术本科二批|艺术本科批A段|艺术本科批B段|艺术本科批C段|艺术本科提前批|艺术本科提前批B段|艺术类专科批|艺术类专科提前批|艺术类本科A段|艺术类本科B段|艺术类本科批|艺术类本科批A段|艺术类本科批B段|艺术类本科提前批|艺术类本科提前批B段|艺术类第一批|艺术类第二批|艺术类第二批B段|艺术类（本科二批B段）|零志愿批次|零批次|高校专项计划|高校专项计划批次|高校专项计划本科批|高职（专科）批R段",
            "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": "专业所属的类型，传递参数可选值为：3+证书|会计类|体育文|体育理|体育类|体育类（历史）|体育类（物理）|其他艺术|农学类|农林类|医学类|历史类|园林类|土建类|学考|学考文|学考理|幼师类|建筑类|护理类|教育类|文科|旅游类|服装设计与工艺类|机械加工类|汉授美术|汉授音乐|汽车类|汽驾类|烹饪类|牧医类|物理类|理科|电子商务类|电子技术类|电气技术类|畜牧兽医类|综合|美工设计类|美术类|艺术文|艺术理|艺术类|艺术类（历史）|艺术类（物理）|药剂类|蒙授体育|蒙授文科|蒙授理科|蒙牧医类|计算机类|财会类|财经类|音乐类",
            "schema": {
              "type": "string",
              "enum": [
                "3+证书",
                "会计类",
                "体育文",
                "体育理",
                "体育类",
                "其他艺术",
                "农学类",
                "农林类",
                "医学类",
                "历史类",
                "园林类",
                "土建类",
                "学考",
                "学考文",
                "学考理",
                "幼师类",
                "建筑类",
                "护理类",
                "教育类",
                "文科",
                "旅游类",
                "服装设计与工艺类",
                "机械加工类",
                "汉授美术",
                "汉授音乐",
                "汽车类",
                "汽驾类",
                "烹饪类",
                "牧医类",
                "物理类",
                "理科",
                "电子商务类",
                "电子技术类",
                "电气技术类",
                "畜牧兽医类",
                "综合",
                "美工设计类",
                "美术类",
                "艺术文",
                "艺术理",
                "艺术类",
                "药剂类",
                "蒙授体育",
                "蒙授文科",
                "蒙授理科",
                "蒙牧医类",
                "计算机类",
                "财会类",
                "财经类",
                "音乐类"
              ]
            }
          },
          {
            "name": "schooluuid",
            "in": "query",
            "required": false,
            "description": "咕咕数据平台高校唯一 ID，此唯一 ID 可与 <a href='https://www.gugudata.com/api/details/college' target='_blank'>全国大学高校基础信息</a>、<a href='https://www.gugudata.com/api/details/ceemajorline' target='_blank'>历年高考专业录取分数线</a> 等接口中的 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": "选科要求筛选条件，如：首选物理，再选化学。传递参数可选值为：不限|化/史/地(3选1)|化/史/生(3选1)|化/地/史(3选1)|化/地/生(3选1)|化/政/史(3选1)|化/政/生(3选1)|化/生/史(3选1)|化/生/地(3选1)|化/生/政(3选1)|化学/地理(2选1)|化学/生物(2选1)|化学、物理(2科必选)|化学、生物(2科必选)|化学必选|历史/地理(2选1)|历史/思想政治(2选1)|历史/物理(2选1)|历史/生物(2选1)|历史、地理(2科必选)|历史、思想政治(2科必选)|历史、生物(2科必选)|历史必选|史/化/地(3选1)|史/化/政(3选1)|史/化/生(3选1)|史/地/化(3选1)|史/地/物(3选1)|史/地/生(3选1)|史/政/地(3选1)|史/物/化(3选1)|史/物/生(3选1)|史/生/地(3选1)|史/生/政(3选1)|史、政、地(3科必选)|史、生、地(3科必选)|地/化/生(3选1)|地/史/生(3选1)|地/物/化(3选1)|地/物/生(3选1)|地、史、政(3科必选)|地化物(3科必选)|地史政(3科必选)|地政物(3科必选)|地理/历史(2选1)|地理/物理(2选1)|地理、历史(2科必选)|地理、物理(2科必选)|地理必选|思想政治/历史(2选1)|思想政治/地理(2选1)|思想政治、历史(2科必选)|思想政治必选|政/化/生(3选1)|政/史/化(3选1)|政/史/地(3选1)|政/史/物(3选1)|政/史/生(3选1)|政/地/史(3选1)|政/地/物(3选1)|政/地/生(3选1)|政/物/化(3选1)|政/物/生(3选1)|政、地、史(3科必选)|政地史(3科必选)|物/化/史(3选1)|物/化/地(3选1)|物/化/政(3选1)|物/化/生(3选1)|物/史/化(3选1)|物/史/地(3选1)|物/史/政(3选1)|物/史/生(3选1)|物/地/史(3选1)|物/地/生(3选1)|物/政/史(3选1)|物/政/地(3选1)|物/政/生(3选1)|物/生/史(3选1)|物/生/地(3选1)|物/生/政(3选1)|物、化、地(3科必选)|物、化、生(3科必选)|物化生(3科必选)|物理/化学(2选1)|物理/历史(2选1)|物理/地理(2选1)|物理/思想政治(2选1)|物理/生物(2选1)|物理、化学(2科必选)|物理、地理(2科必选)|物理、思想政治(2科必选)|物理、生物(2科必选)|物理必选|生/史/地(3选1)|生/政/史(3选1)|生/政/地(3选1)|生化物(3科必选)|生物/历史(2选1)|生物、化学(2科必选)|生物、物理(2科必选)|生物必选|首选不限，再选不限|首选不限，再选化学|首选历史，再选不限|首选历史，再选化学|首选历史，再选化学/地理(2选1)|首选历史，再选化学/思想政治(2选1)|首选历史，再选化学/生物(2选1)|首选历史，再选化学、地理(2科必选)|首选历史，再选化学、生物(2科必选)|首选历史，再选地理|首选历史，再选地理/生物(2选1)|首选历史，再选思想政治|首选历史，再选思想政治/地理(2选1)|首选历史，再选思想政治/生物(2选1)|首选历史，再选思想政治、地理(2科必选)|首选历史，再选生物|首选历史，再选生物/地理(2选1)|首选历史，再选生物/思想政治(2选1)|首选历史，再选生物、地理(2科必选)|首选历史，再选生物、思想政治(2科必选)|首选物理，再选不限|首选物理，再选化学|首选物理，再选化学/地理(2选1)|首选物理，再选化学/思想政治(2选1)|首选物理，再选化学/生物(2选1)|首选物理，再选化学、地理(2科必选)|首选物理，再选化学、生物(2科必选)|首选物理，再选地理|首选物理，再选地理/生物(2选1)|首选物理，再选地理、生物(2科必选)|首选物理，再选思想政治|首选物理，再选思想政治/地理(2选1)|首选物理，再选思想政治/生物(2选1)|首选物理，再选思想政治、地理(2科必选)|首选物理，再选生物|首选物理，再选生物/地理(2选1)|首选物理，再选生物/思想政治(2选1)|首选物理，再选生物、地理(2科必选)",
            "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
          }
        ]
      }
    },
    "/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": {
                        "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": "year",
            "in": "query",
            "required": false,
            "description": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": 2025
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": false,
            "description": "year 与 provinceName 为必填参数。建议先查询枚举后，再调用主接口筛选。",
            "schema": {
              "type": "string"
            },
            "example": "上海"
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/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": "录取学科分类，综合、文科理科等。枚举值：理科 | 文科 | 综合 | 艺术类 | 物理类 | 历史类 | 体育类 | 艺术文 | 艺术理 | 体育理 | 体育文 | 蒙授理科 | 蒙授文科 | 汉授美术 | 汉授音乐 | 汉授编导 | 汉授其他艺术 | 蒙授其他艺术 | 蒙授体育 | 蒙授音乐 | 蒙授美术 | 汉授体育 | 学考理 | 医学类 | 学考文 | 广播电视编导类 | 舞蹈类 | 美术类 | 音乐类 | 计算机类 | 农学类 | 财会类 | 化工类 | 美工设计类 | 牧医类 | 采矿类 | 幼师类 | 蒙牧医类 | 旅游类 | 机电类 | 建筑类 | 汽驾类 | 书法类 | 农林类 | 烹饪类 | 畜牧兽医类"
                        },
                        "ScoreBatch": {
                          "type": "string",
                          "description": "录取批次。枚举值：本科二批 | 本科一批 | 专科批 | 本科三批 | 艺术类（本科） | 艺术类（高职专科） | 体育类（本科） | 本科批 | 体育类（高职专科） | 专科一批 | 特殊类型招生控制线 | 本科二批C段 | 艺术类（本科批） | 体育类（本科一批） | 体育类（本科二批） | 专科批（汉族） | 专科批（独立学院、民办、省属高职除武汉） | 专科批（少数民族） | 专科提前批 | 高水平运动队 | 体育类（本科批） | 普通本科（汉族） | 艺术类（本科一批） | 普通本科（少数民族） | 艺术类（本科二批） | 专科二批 | 自招线 | 艺术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 - 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "录取学科分类筛选，综合、文科理科等。可选枚举值：理科 | 文科 | 综合 | 艺术类 | 物理类 | 历史类 | 体育类 | 艺术文 | 艺术理 | 体育理 | 体育文 | 蒙授理科 | 蒙授文科 | 汉授美术 | 汉授音乐 | 汉授编导 | 汉授其他艺术 | 蒙授其他艺术 | 蒙授体育 | 蒙授音乐 | 蒙授美术 | 汉授体育 | 学考理 | 医学类 | 学考文 | 广播电视编导类 | 舞蹈类 | 美术类 | 音乐类 | 计算机类 | 农学类 | 财会类 | 化工类 | 美工设计类 | 牧医类 | 采矿类 | 幼师类 | 蒙牧医类 | 旅游类 | 机电类 | 建筑类 | 汽驾类 | 书法类 | 农林类 | 烹饪类 | 畜牧兽医类",
            "schema": {
              "type": "string",
              "enum": [
                "理科",
                "文科",
                "综合",
                "艺术类",
                "物理类",
                "历史类",
                "体育类",
                "艺术文",
                "艺术理",
                "体育理",
                "体育文",
                "蒙授理科",
                "蒙授文科",
                "汉授美术",
                "汉授音乐",
                "汉授编导",
                "汉授其他艺术",
                "蒙授其他艺术",
                "蒙授体育",
                "蒙授音乐",
                "蒙授美术",
                "汉授体育",
                "学考理",
                "医学类",
                "学考文",
                "广播电视编导类",
                "舞蹈类",
                "美术类",
                "音乐类",
                "计算机类",
                "农学类",
                "财会类",
                "化工类",
                "美工设计类",
                "牧医类",
                "采矿类",
                "幼师类",
                "蒙牧医类",
                "旅游类",
                "机电类",
                "建筑类",
                "汽驾类",
                "书法类",
                "农林类",
                "烹饪类",
                "畜牧兽医类"
              ]
            }
          }
        ]
      }
    },
    "/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 至 2026；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": "专业门类/一级分类，可先调用关联接口获取可用枚举。",
            "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": "专业类/二级分类，可先调用关联接口获取可用枚举。",
            "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": "录取批次名称，可先调用关联接口获取当前年份和省份下的可用批次。",
            "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": "科类/选科类型，可先调用关联接口获取当前年份和省份下的可用科类。",
            "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
          }
        ]
      }
    },
    "/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": "年份，如 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": true,
            "description": "省份名称，如 上海、上海市。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/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": "招生年份，如 2026。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": false,
            "description": "招生省份，如 河南、河北。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "batchName",
            "in": "query",
            "required": false,
            "description": "录取批次，如 本科批。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "typeName",
            "in": "query",
            "required": false,
            "description": "科类或选科类别，如 物理类、历史类、理科、文科、综合。",
            "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
          }
        ]
      }
    },
    "/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
          }
        ]
      }
    },
    "/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"
            }
          }
        ]
      }
    },
    "/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": "年份，如 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "provinceName",
            "in": "query",
            "required": true,
            "description": "省份名称，如 上海、上海市。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/metadata/postgraduate-national-score-line": {
      "get": {
        "summary": "研究生招生国家分数线",
        "description": "考研国家线数据查询\n接口标签：基础数据、研究生招生、考研国家线、分数线\n接口特性：\n- 支持查询 2001-2026 年研究生招生考试国家线\n- 覆盖学科门类、专业学位类别、专项计划、照顾政策和历史考生分类\n- 返回 A/B/C 区总分和单科分数要求\n- 仅包含国家线，不包含学校复试线或院系学科线\n- 围绕“研究生招生国家分数线”提供标准化能力，便于快速接入现有业务\n- 适合将“研究生招生国家分数线”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/postgraduatenationalscoreline",
        "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": ""
          },
          {
            "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": {
                        "Year": {
                          "type": "integer",
                          "format": "int32",
                          "description": "考试年份"
                        },
                        "LineScope": {
                          "type": "string",
                          "description": "国家线层级或类型中文名称"
                        },
                        "DisciplineCategoryName": {
                          "type": "string",
                          "description": "学科门类、专业学位类别、专项计划或照顾政策名称"
                        },
                        "CandidateRegion": {
                          "type": "string",
                          "description": "考生区域或历史考生分类"
                        },
                        "TotalScore": {
                          "type": "integer",
                          "format": "int32",
                          "description": "总分要求"
                        },
                        "SingleSubject100Text": {
                          "type": "string",
                          "description": "满分等于 100 分的单科分数要求"
                        },
                        "SingleSubjectOver100Text": {
                          "type": "string",
                          "description": "满分大于 100 分的单科分数要求"
                        }
                      },
                      "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/postgraduate-national-score-line/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "考试年份，支持 2001-2026，默认 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 2026
          },
          {
            "name": "disciplineCategoryName",
            "in": "query",
            "required": false,
            "description": "学科门类、专业学位类别、专项计划或照顾政策名称关键词",
            "schema": {
              "type": "string"
            },
            "example": "哲学"
          },
          {
            "name": "lineScope",
            "in": "query",
            "required": false,
            "description": "国家线层级或类型。支持国家线-按学科门类统一划线、国家线-学术学位、国家线-专业学位、国家线-专项计划和照顾政策、国家线-单独划线学科专业；也支持 national_unified、national_academic、national_professional、national_special、national_separate 等英文值。",
            "schema": {
              "type": "string"
            },
            "example": "国家线-按学科门类统一划线"
          },
          {
            "name": "degreeType",
            "in": "query",
            "required": false,
            "description": "学位类型，支持 academic、professional、学术学位、专业学位；仅对按学位类型拆分的年份有效",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "candidateRegion",
            "in": "query",
            "required": false,
            "description": "考生区域或历史考生分类。常见值包括 A区、B区、C区；部分历史年份包含应届生、往届生、A区-应届生、A区-非应届生等，请按返回值原样筛选。",
            "schema": {
              "type": "string"
            },
            "example": "A区"
          },
          {
            "name": "pageindex",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "每页条数，取值范围 1~20",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          }
        ]
      }
    },
    "/metadata/postgraduate-program": {
      "get": {
        "summary": "研究生招生专业目录",
        "description": "研究生招生专业、研究方向、考试科目等数据\n接口标签：基础数据、研究生招生、高校基础数据、招生专业目录\n接口特性：\n- 支持按招生年份查询研究生招生专业数据，2026 年数据已更新\n- 覆盖招生单位、院系、专业、研究方向、考试科目和拟招生人数\n- 提供招生简章标题、发布日期和摘要\n- 可通过 SchoolUUID 与全国大学高校基础信息接口关联\n- 围绕“研究生招生专业目录”提供标准化能力，便于快速接入现有业务\n- 适合将“研究生招生专业目录”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/postgraduateprogram",
        "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": ""
          },
          {
            "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": {
                        "Year": {
                          "type": "integer",
                          "format": "int32",
                          "description": "招生年份"
                        },
                        "SchoolUUID": {
                          "type": "string",
                          "description": "咕咕数据平台高校唯一 ID，无法可靠关联时为空"
                        },
                        "SchoolCode": {
                          "type": "string",
                          "description": "招生单位代码"
                        },
                        "SchoolName": {
                          "type": "string",
                          "description": "招生单位名称"
                        },
                        "Province": {
                          "type": "string",
                          "description": "招生单位所在省份"
                        },
                        "City": {
                          "type": "string",
                          "description": "招生单位所在城市"
                        },
                        "CoverImage": {
                          "type": "string",
                          "description": "学校封面图或校徽图片"
                        },
                        "IsDoubleFirstClass": {
                          "type": "boolean",
                          "description": "是否为双一流建设高校"
                        },
                        "HasGraduateSchool": {
                          "type": "boolean",
                          "description": "是否设有研究生院"
                        },
                        "IsSelfMarking": {
                          "type": "boolean",
                          "description": "是否为自主划线招生单位"
                        },
                        "DepartmentName": {
                          "type": "string",
                          "description": "院系名称"
                        },
                        "MajorCode": {
                          "type": "string",
                          "description": "专业代码"
                        },
                        "MajorName": {
                          "type": "string",
                          "description": "专业名称"
                        },
                        "DegreeType": {
                          "type": "string",
                          "description": "学位类型"
                        },
                        "DisciplineCategoryCode": {
                          "type": "string",
                          "description": "门类代码"
                        },
                        "DisciplineCategoryName": {
                          "type": "string",
                          "description": "门类名称"
                        },
                        "FirstLevelDisciplineCode": {
                          "type": "string",
                          "description": "一级学科或专业学位类别代码"
                        },
                        "FirstLevelDisciplineName": {
                          "type": "string",
                          "description": "一级学科或专业学位类别名称"
                        },
                        "DirectionName": {
                          "type": "string",
                          "description": "研究方向名称"
                        },
                        "StudyMode": {
                          "type": "string",
                          "description": "学习方式"
                        },
                        "ExamMethod": {
                          "type": "string",
                          "description": "考试方式"
                        },
                        "Advisor": {
                          "type": "string",
                          "description": "导师信息"
                        },
                        "PlannedEnrollmentText": {
                          "type": "string",
                          "description": "拟招生人数文本"
                        },
                        "Remark": {
                          "type": "string",
                          "description": "专业备注"
                        },
                        "ExamSubjectGroups": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "考试科目组"
                        },
                        "BrochureTitle": {
                          "type": "string",
                          "description": "招生简章标题"
                        },
                        "BrochurePublishedDate": {
                          "type": "string",
                          "description": "招生简章发布日期"
                        },
                        "BrochureSummary": {
                          "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/postgraduate-program/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "招生年份，默认 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 2026
          },
          {
            "name": "schooluuid",
            "in": "query",
            "required": false,
            "description": "咕咕数据平台高校唯一 ID",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "schoolcode",
            "in": "query",
            "required": false,
            "description": "招生单位代码",
            "schema": {
              "type": "string"
            },
            "example": 10001
          },
          {
            "name": "schoolname",
            "in": "query",
            "required": false,
            "description": "招生单位名称关键词",
            "schema": {
              "type": "string"
            },
            "example": "北京大学"
          },
          {
            "name": "province",
            "in": "query",
            "required": false,
            "description": "招生单位所在省份",
            "schema": {
              "type": "string"
            },
            "example": "北京"
          },
          {
            "name": "majorcode",
            "in": "query",
            "required": false,
            "description": "专业代码",
            "schema": {
              "type": "string"
            },
            "example": 10101
          },
          {
            "name": "majorname",
            "in": "query",
            "required": false,
            "description": "专业名称关键词",
            "schema": {
              "type": "string"
            },
            "example": "哲学"
          },
          {
            "name": "degreeType",
            "in": "query",
            "required": false,
            "description": "学位类型，支持 academic、professional、学术学位、专业学位",
            "schema": {
              "type": "string"
            },
            "example": "academic"
          },
          {
            "name": "studyMode",
            "in": "query",
            "required": false,
            "description": "学习方式，支持 full_time、part_time、全日制、非全日制",
            "schema": {
              "type": "string"
            },
            "example": "full_time"
          },
          {
            "name": "isDoubleFirstClass",
            "in": "query",
            "required": false,
            "description": "是否筛选双一流建设高校",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "isSelfMarking",
            "in": "query",
            "required": false,
            "description": "是否筛选自主划线招生单位",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "pageindex",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "每页条数，取值范围 1~20",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          }
        ]
      }
    },
    "/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": "招生类别编码，如 75011。传空则不按类别编码筛选",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "招生类别名称，如：职教高考、3+证书等。建议先调用 /metadata/vocational-control-lines/enums 获取可选值",
            "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": "考生类型，如：其他考生。建议先调用 /metadata/vocational-control-lines/enums 获取可选值",
            "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": "录取批次，如：本科、专科第一批次。建议先调用 /metadata/vocational-control-lines/enums 获取可选值",
            "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": "科类名称，如：财会、体育、计算机。建议先调用 /metadata/vocational-control-lines/enums 获取可选值",
            "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
          }
        ]
      }
    },
    "/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"
            }
          }
        ]
      }
    },
    "/news/fetchcontent": {
      "post": {
        "summary": "获取任意链接文章正文",
        "description": "智能分析抓取链接中的正文部分\n接口标签：网络工具、文本处理、智能分析正文、包含 HTML 标签\n接口特性：\n- 根据提供的文章链接智能分析出文章正文\n- 返回正文提供了纯文本和包含 HTML 标签两个模式\n- 接口可同时返回原始 HTML 内容，供您二次解析使用\n- 数据抓取与文章标签处理基于机器学习\n- 围绕“获取任意链接文章正文”提供标准化能力，便于快速接入现有业务\n- 适合将“获取任意链接文章正文”结果接入业务系统、后台工具和自动化流程\n- 适合资讯聚合、内容归档和运营素材整理场景\n- 支持将文章、图片或封面结果接入内容管理系统\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": "智能分析出的文章正文部分（包含 HTML 标签时，标签为 Unicode 编码）"
                        },
                        "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 标签"
                  },
                  "htmlsourcecontent": {
                    "type": "boolean",
                    "description": "是否返回文章页面原始 HTML 内容，供您二次解析或分析正文失败时使用，需要注意接口的性能问题"
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "YOUR_VALUE",
                "contentwithhtml": false,
                "htmlsourcecontent": false
              }
            }
          }
        }
      }
    },
    "/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
              }
            }
          }
        }
      }
    },
    "/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
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/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": "<a href='https://www.iso.org/iso-3166-country-codes.html' target='_blank'>ISO-3166</a> 标准两位国家代码"
                        },
                        "CountryCode3": {
                          "type": "string",
                          "description": "<a href='https://www.iso.org/iso-3166-country-codes.html' target='_blank'>ISO-3166</a> 标准三位国家代码"
                        }
                      },
                      "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"
          }
        ]
      }
    },
    "/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"
          }
        ]
      }
    },
    "/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 href='/enum/stockcn/symbols' target='_blank'>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"
          }
        ]
      }
    },
    "/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": "资产负债表.报表日期<br />资产负债表.单位<br />资产负债表.资产<br />资产负债表.现金及存放中央银行款项<br />资产负债表.存放同业款项<br />资产负债表.拆出资金<br />资产负债表.贵金属<br />资产负债表.交易性金融资产<br />资产负债表.衍生金融工具资产<br />资产负债表.买入返售金融资产<br />资产负债表.应收利息<br />资产负债表.发放贷款及垫款<br />资产负债表.代理业务资产<br />资产负债表.可供出售金融资产<br />资产负债表.持有至到期投资<br />资产负债表.长期股权投资<br />资产负债表.应收投资款项<br />资产负债表.固定资产合计<br />资产负债表.无形资产<br />资产负债表.商誉<br />资产负债表.递延税款借项<br />资产负债表.投资性房地产<br />资产负债表.其他资产<br />资产负债表.资产总计<br />资产负债表.负债<br />资产负债表.向中央银行借款<br />资产负债表.同业存入及拆入<br />资产负债表.其中:同业存放款项<br />资产负债表.拆入资金<br />资产负债表.衍生金融工具负债<br />资产负债表.交易性金融负债<br />资产负债表.卖出回购金融资产款<br />资产负债表.客户存款(吸收存款)<br />资产负债表.应付职工薪酬<br />资产负债表.应交税费<br />资产负债表.应付利息<br />资产负债表.应付账款<br />资产负债表.代理业务负债<br />资产负债表.应付债券<br />资产负债表.递延所得税负债<br />资产负债表.预计负债<br />资产负债表.其他负债<br />资产负债表.负债合计<br />资产负债表.所有者权益<br />资产负债表.股本<br />资产负债表.其他权益工具<br />资产负债表.其中：优先股<br />资产负债表.资本公积<br />资产负债表.减:库藏股<br />资产负债表.其他综合收益<br />资产负债表.盈余公积<br />资产负债表.未分配利润<br />资产负债表.一般风险准备<br />资产负债表.外币报表折算差额<br />资产负债表.其他储备<br />资产负债表.归属于母公司股东的权益<br />资产负债表.少数股东权益<br />资产负债表.股东权益合计<br />资产负债表.负债及股东权益总计"
                              },
                              "利润表": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "利润表.报表日期<br />利润表.单位<br />利润表.一、营业收入<br />利润表.利息净收入<br />利润表.其中：利息收入<br />利润表.减：利息支出<br />利润表.手续费及佣金净收入<br />利润表.其中:手续费及佣金收入<br />利润表.减：手续费及佣金支出<br />利润表.汇兑收益<br />利润表.投资净收益<br />利润表.其中:对联营公司的投资收益<br />利润表.公允价值变动净收益<br />利润表.其他业务收入<br />利润表.二、营业支出<br />利润表.营业税金及附加<br />利润表.业务及管理费用<br />利润表.研发费用<br />利润表.资产减值损失<br />利润表.其他业务支出<br />利润表.三、营业利润<br />利润表.加:营业外收入<br />利润表.减:营业外支出<br />利润表.四、利润总额<br />利润表.减:所得税<br />利润表.五、净利润<br />利润表.归属于母公司的净利润<br />利润表.少数股东权益<br />利润表.六、每股收益<br />利润表.基本每股收益(元/股)<br />利润表.稀释每股收益(元/股)<br />利润表.七、其他综合收益<br />利润表.八、综合收益总额<br />利润表.归属于母公司所有者的综合收益总额<br />利润表.归属于少数股东的综合收益总额"
                              },
                              "现金流量表": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "现金流量表.报表日期<br />现金流量表.单位<br />现金流量表.一、经营活动产生的现金流量<br />现金流量表.客户存款和同业存放款项净增加额<br />现金流量表.向央行借款净增加额<br />现金流量表.向其他金融机构拆入资金净增加额<br />现金流量表.收取利息、手续费及佣金的现金<br />现金流量表.收到其他与经营活动有关的现金<br />现金流量表.经营活动现金流入小计<br />现金流量表.客户贷款及垫款净增加额<br />现金流量表.存放中央银行和同业款项净增加额<br />现金流量表.支付给职工以及为职工支付的现金<br />现金流量表.支付的各项税费<br />现金流量表.支付其他与经营活动有关的现金<br />现金流量表.支付利息、手续费及佣金的现金<br />现金流量表.经营活动现金流出小计<br />现金流量表.经营活动产生的现金流量净额<br />现金流量表.二、投资活动产生的现金流量<br />现金流量表.收回投资收到的现金<br />现金流量表.取得投资收益收到的现金<br />现金流量表.处置固定资产、无形资产及其他资产而收到的现金<br />现金流量表.取得子公司及其他营业单位所收到的现金净额<br />现金流量表.收到其他与投资活动有关的现金<br />现金流量表.投资活动现金流入小计<br />现金流量表.投资支付的现金<br />现金流量表.购建固定资产、无形资产和其他长期资产支付的现金<br />现金流量表.支付的其他与投资活动有关的现金<br />现金流量表.投资活动现金流出小计<br />现金流量表.投资活动产生的现金流量净额<br />现金流量表.三、筹资活动产生的现金流量<br />现金流量表.吸收投资所收到的现金<br />现金流量表.发行证券化资产所吸收的现金<br />现金流量表.发行债券收到的现金<br />现金流量表.增加股本所收到的现金<br />现金流量表.收到其他与筹资活动有关的现金<br />现金流量表.筹资活动现金流入小计<br />现金流量表.偿还债务所支付的现金<br />现金流量表.分配股利、利润或偿付利息支付的现金<br />现金流量表.其中:偿付利息所支付的现金<br />现金流量表.支付新股发行费用<br />现金流量表.支付其他与筹资活动有关的现金<br />现金流量表.筹资活动现金流出小计<br />现金流量表.筹资活动产生的现金流量净额<br />现金流量表.四、汇率变动对现金及现金等价物的影响<br />现金流量表.五、现金及现金等价物净增加额<br />现金流量表.加:期初现金及现金等价物余额<br />现金流量表.六、期末现金及现金等价物余额<br />现金流量表.附注<br />现金流量表.净利润<br />现金流量表.加:少数股东收益<br />现金流量表.计提的资产减值准备<br />现金流量表.其中：计提的坏账准备<br />现金流量表.计提的贷款损失准备<br />现金流量表.冲回存放同业减值准备<br />现金流量表.固定资产折旧、油气资产折耗、生产性生物资产折旧<br />现金流量表.投资性房地产折旧<br />现金流量表.无形资产、递延资产及其他资产的摊销<br />现金流量表.其中:无形资产摊销<br />现金流量表.长期待摊费用摊销<br />现金流量表.长期资产摊销<br />现金流量表.处置固定资产、无形资产和其他长期产的损失/(收益)<br />现金流量表.处置投资性房地产的损失/(收益)<br />现金流量表.固定资产报废损失<br />现金流量表.财务费用<br />现金流量表.投资损失(减:收益)<br />现金流量表.公允价值变动(收益)/损失<br />现金流量表.汇兑损益<br />现金流量表.衍生金融工具交易净损益<br />现金流量表.折现回拔(减值资产利息冲转)<br />现金流量表.存货的减少<br />现金流量表.贷款的减少<br />现金流量表.存款的增加<br />现金流量表.拆借款项的净增<br />现金流量表.金融性资产的减少<br />现金流量表.预计负债的增加<br />现金流量表.收到已核销款项<br />现金流量表.递延所得税资产的减少<br />现金流量表.递延所得税负债的增加<br />现金流量表.经营性应收项目的增加<br />现金流量表.经营性应付项目的增加<br />现金流量表.经营性其他资产的减少<br />现金流量表.经营性其他负债的增加<br />现金流量表.其他<br />现金流量表.经营活动现金流量净额<br />现金流量表.以固定资产偿还债务<br />现金流量表.以投资偿还债务<br />现金流量表.以固定资产进行投资<br />现金流量表.债务转为资本<br />现金流量表.一年内到期的可转换公司债券<br />现金流量表.融资租入固定资产<br />现金流量表.其他不涉及现金收支的投资和筹资活动金额<br />现金流量表.现金的期末余额<br />现金流量表.减:现金的期初余额<br />现金流量表.现金等价物的期末余额<br />现金流量表.减：现金等价物的期初余额<br />现金流量表.现金及现金等价物净增加额"
                              }
                            }
                          },
                          "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/annualreport/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "传递单支股票代码，如: 600031。可通过前置接口或参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a>",
            "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": "type",
            "in": "query",
            "required": true,
            "description": "三大财报类型，可选值为：资产负债表|利润表|现金流量表",
            "schema": {
              "type": "string",
              "enum": [
                "资产负债表",
                "利润表",
                "现金流量表"
              ]
            }
          }
        ]
      }
    },
    "/stock/cn/financialindicator": {
      "get": {
        "summary": "A 股历年财务指标",
        "description": "历年所有财报数据\n接口标签：股票、A股、全量A股数据、历年实时财务指标\n接口特性：\n- 支持所有 A 股全量财务指标数据查询\n- 分别包括每股指标、盈利能力、成长能力、营运能力、偿债及资本结构、现金流量、其他指标数据\n- 返回 80 多项财务指标\n- 多数据源清洗整合，百万级数据毫秒级返回\n- 围绕“A 股历年财务指标”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股历年财务指标”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/financialindicator",
        "operationId": "get_financialindicator",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/financialindicator"
        },
        "x-gugudata-api-identity": "financialindicator",
        "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": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "description": "日期<br/>摊薄每股收益(元)<br/>加权每股收益(元)<br/>每股收益_调整后(元)<br/>扣除非经常性损益后的每股收益(元)<br/>每股净资产_调整前(元)<br/>每股净资产_调整后(元)<br/>每股经营性现金流(元)<br/>每股资本公积金(元)<br/>每股未分配利润(元)<br/>调整后的每股净资产(元)<br/>总资产利润率(%)<br/>主营业务利润率(%)<br/>总资产净利润率(%)<br/>成本费用利润率(%)<br/>营业利润率(%)<br/>主营业务成本率(%)<br/>销售净利率(%)<br/>股本报酬率(%)<br/>净资产报酬率(%)<br/>资产报酬率(%)<br/>销售毛利率(%)<br/>三项费用比重<br/>非主营比重<br/>主营利润比重<br/>股息发放率(%)<br/>投资收益率(%)<br/>主营业务利润(元)<br/>净资产收益率(%)<br/>加权净资产收益率(%)<br/>扣除非经常性损益后的净利润(元)<br/>主营业务收入增长率(%)<br/>净利润增长率(%)<br/>净资产增长率(%)<br/>总资产增长率(%)<br/>应收账款周转率(次)<br/>应收账款周转天数(天)<br/>存货周转天数(天)<br/>存货周转率(次)<br/>固定资产周转率(次)<br/>总资产周转率(次)<br/>总资产周转天数(天)<br/>流动资产周转率(次)<br/>流动资产周转天数(天)<br/>股东权益周转率(次)<br/>流动比率<br/>速动比率<br/>现金比率(%)<br/>利息支付倍数<br/>长期债务与营运资金比率(%)<br/>股东权益比率(%)<br/>长期负债比率(%)<br/>股东权益与固定资产比率(%)<br/>负债与所有者权益比率(%)<br/>长期资产与长期资金比率(%)<br/>资本化比率(%)<br/>固定资产净值率(%)<br/>资本固定化比率(%)<br/>产权比率(%)<br/>清算价值比率(%)<br/>固定资产比重(%)<br/>资产负债率(%)<br/>总资产(元)<br/>经营现金净流量对销售收入比率(%)<br/>资产的经营现金流量回报率(%)<br/>经营现金净流量与净利润的比率(%)<br/>经营现金净流量对负债比率(%)<br/>现金流量比率(%)<br/>短期股票投资(元)<br/>短期债券投资(元)<br/>短期其它经营性投资(元)<br/>长期股票投资(元)<br/>长期债券投资(元)<br/>长期其它经营性投资(元)<br/>1年以内应收帐款(元)<br/>1-2年以内应收帐款(元)<br/>2-3年以内应收帐款(元)<br/>3年以内应收帐款(元)<br/>1年以内预付货款(元)<br/>1-2年以内预付货款(元)<br/>2-3年以内预付货款(元)<br/>3年以内预付货款(元)<br/>1年以内其它应收款(元)<br/>1-2年以内其它应收款(元)<br/>2-3年以内其它应收款(元)<br/>3年以内其它应收款(元)"
                        }
                      },
                      "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/financialindicator/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "传递单支股票代码，如: 600031。可通过前置接口或参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a>",
            "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"
          }
        ]
      }
    },
    "/stock/cn/fundamentalinfo": {
      "get": {
        "summary": "A 股个股信息查询",
        "description": "A 股上市公司核心资料画像\n接口标签：股票、A股、A 股基础信息、实时基础金融信息\n接口特性：\n- 支持按 A 股代码查询上市公司基础画像和规模指标\n- 返回股票简称、上市时间、行业、总股本、总市值、流通股本和流通市值等常用字段\n- symbol 可使用 6 位代码或 sh/sz 前缀代码，适合与行情、财报和资金流接口联动\n- 适合股票资料页、投研基础库、证券列表补全和公司画像展示等场景\n- 围绕“A 股个股信息查询”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股个股信息查询”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/fundamentalinfo",
        "operationId": "get_fundamentalinfo",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/fundamentalinfo"
        },
        "x-gugudata-api-identity": "fundamentalinfo",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票简称。"
                        },
                        "ListingTime": {
                          "type": "string",
                          "description": "上市日期。"
                        },
                        "Industry": {
                          "type": "string",
                          "description": "所属行业。"
                        },
                        "GeneralCapital": {
                          "type": "number",
                          "description": "总股本。"
                        },
                        "TotalValue": {
                          "type": "number",
                          "description": "总市值。"
                        },
                        "CirculationStock": {
                          "type": "number",
                          "description": "流通股本。"
                        },
                        "CirculationMarketValue": {
                          "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/fundamentalinfo/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "A 股股票代码，支持 6 位代码或带市场前缀代码，例如 600519、sh600519、sz000001。",
            "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": 600519
          }
        ]
      }
    },
    "/stock/cn/index/contains": {
      "get": {
        "summary": "A 股指数成分数据",
        "description": "股指成分全量数据\n接口标签：股票、A股、指数、支持指数列表获取、所有成分数据\n接口特性：\n- 支持所有指数数据查询\n- 根据指数代码返回所有包含的股票基础信息\n- 包含收录时间数据\n- 毫秒级查询性能\n- 围绕“A 股指数成分数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股指数成分数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnindexcontains",
        "operationId": "get_stockcnindexcontains",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnindexcontains"
        },
        "x-gugudata-api-identity": "stockcnindexcontains",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码"
                        },
                        "StockName": {
                          "type": "number",
                          "description": "股票名称"
                        },
                        "FeaturedDateTime": {
                          "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/index/contains/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "传递上面获取的指数编码，如: 000001。可通过前置接口或参见 <a href='/enum/stockcnindex2/symbols' target='_blank'>A 股指数代码参数枚举页面</a>",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols",
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/stock/cn/index/history": {
      "get": {
        "summary": "A 股股票指数历史数据",
        "description": "股指历史数据\n接口标签：股票、A股、指数、历史数据、指数列表获取、全量历史数据\n接口特性：\n- 支持所有指数数据查询\n- 支持全量指数历史数据查询\n- 多维度的统计时间以及数据结果\n- 秒级查询性能\n- 围绕“A 股股票指数历史数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股股票指数历史数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnindexhistory",
        "operationId": "get_stockcnindexhistory",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnindexhistory"
        },
        "x-gugudata-api-identity": "stockcnindexhistory",
        "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": "number",
                          "description": "交易时间"
                        },
                        "Symbol": {
                          "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/index/history/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "传递上面获取的指数编码，如: 000001。可通过前置接口或参见 <a href='/enum/stockcnindex2/symbols' target='_blank'>A 股指数代码参数枚举页面</a>",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols",
            "example": "YOUR_VALUE"
          },
          {
            "name": "period",
            "in": "query",
            "required": true,
            "description": "统计周期，参数可选值为 DAILY | WEEKLY | MONTHLY",
            "schema": {
              "type": "string",
              "enum": [
                "DAILY",
                "WEEKLY",
                "MONTHLY"
              ]
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "begindate",
            "in": "query",
            "required": true,
            "description": "历史数据开始时间，格式为 20200101",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "enddate",
            "in": "query",
            "required": true,
            "description": "历史数据结束时间，格式为 20200101，获取全量数据请分批获取，数据量较大，请保持合理的请求频率",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/stock/cn/index/list": {
      "get": {
        "summary": "查询 A 股指数列表",
        "description": "包含股票编码、股票名称、收录时间\n接口标签：股票、A股、指数、历史数据、指数列表获取、全量历史数据\n详情页：https://www.gugudata.com/api/details/stockcnindexhistory",
        "operationId": "get_get_stock_cn_index_list",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnindexhistory"
        },
        "x-gugudata-api-identity": "stockcnindexhistory",
        "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": "stockcnindexhistory",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/stockcnindexhistory",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/stock/cn/index_perminutes": {
      "get": {
        "summary": "A 股指数分时行情数据",
        "description": "A 股指数分钟级行情追踪\n接口标签：股票、A股、指数、分时数据、指数分时、多时间区间查询参数\n接口特性：\n- 支持 A 股指数分时行情查询\n- begindate 与 enddate 支持 yyyyMMdd HH:mm:ss 时间格式\n- 返回指数点位、涨跌幅、成交量、成交额、振幅和换手率等字段\n- 适合指数分时图、市场看板、指数监控和策略回测辅助等场景\n- 围绕“A 股指数分时行情数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股指数分时行情数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnindexperminutes",
        "operationId": "get_stockcnindexperminutes",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnindexperminutes"
        },
        "x-gugudata-api-identity": "stockcnindexperminutes",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "指数代码。"
                        },
                        "TimeKey": {
                          "type": "string",
                          "description": "行情时间。"
                        },
                        "Open": {
                          "type": "number",
                          "description": "开盘点位。"
                        },
                        "Close": {
                          "type": "number",
                          "description": "收盘点位。"
                        },
                        "High": {
                          "type": "number",
                          "description": "最高点位。"
                        },
                        "Low": {
                          "type": "number",
                          "description": "最低点位。"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅，单位：%。"
                        },
                        "ChangeAmount": {
                          "type": "number",
                          "description": "涨跌额。"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量。"
                        },
                        "TradingAmount": {
                          "type": "number",
                          "description": "成交额。"
                        },
                        "Swing": {
                          "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/index_perminutes/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "A 股指数代码，支持带市场前缀代码，例如 sh000001、sz399001。",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex2/symbols",
            "example": "sh000001"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "分时周期，单位：分钟；需使用接口支持的周期值。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 5
          },
          {
            "name": "begindate",
            "in": "query",
            "required": true,
            "description": "查询开始时间，支持 yyyyMMdd HH:mm:ss；部分场景也支持 yyyyMMdd。",
            "schema": {
              "type": "string"
            },
            "example": "20240102 09:30:00"
          },
          {
            "name": "enddate",
            "in": "query",
            "required": true,
            "description": "查询结束时间，支持 yyyyMMdd HH:mm:ss；部分场景也支持 yyyyMMdd。",
            "schema": {
              "type": "string"
            },
            "example": "20240102 15:00:00"
          }
        ]
      }
    },
    "/stock/cn/options": {
      "get": {
        "summary": "A 股期权实时行情数据",
        "description": "所有期权实时行情数据\n接口标签：股票、A股、期权、期权实时数据、支持代码筛选\n接口特性：\n- 支持所有期权实时行情数据查询\n- 包含期权实时行情交易多项指标数据\n- 毫秒级查询性能\n- 围绕“A 股期权实时行情数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股期权实时行情数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n- 支持按股票、指数、交易日或指标维度组织结果\n详情页：https://www.gugudata.com/api/details/stockcnoptions",
        "operationId": "get_stockcnoptions",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnoptions"
        },
        "x-gugudata-api-identity": "stockcnoptions",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "期权代码"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "期权名称"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "最新价，单位：元"
                        },
                        "ChangeAmount": {
                          "type": "number",
                          "description": "涨跌额，单位：元"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅，单位：%"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量"
                        },
                        "TradingAmount": {
                          "type": "number",
                          "description": "成交额，单位：元"
                        },
                        "HoldingVolume": {
                          "type": "number",
                          "description": "持仓量"
                        },
                        "ExercisePrice": {
                          "type": "number",
                          "description": "行权价"
                        },
                        "RemainingDay": {
                          "type": "number",
                          "description": "剩余日"
                        },
                        "DailyIncrease": {
                          "type": "number",
                          "description": "日增"
                        },
                        "PreClose": {
                          "type": "number",
                          "description": "昨收价"
                        },
                        "Open": {
                          "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/options/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "默认不传递或传递空值，则获取所有期权实时行情数据（需要注意在获取全量数据时，数据量传输对接口调用性能的影响）。支持传递单支或者多支(使用英文逗号分隔)期权代码进行筛选，格式为: ni2506C146000,sn2506C335000",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/stock/cn/performance-statement": {
      "get": {
        "summary": "A 股业绩报表数据",
        "description": "A 股上市公司季度业绩报表数据\n接口标签：股票、A股、全量数据、业绩报表\n接口特性：\n- 提供 A 股上市公司季度业绩报表数据\n- 支持按年份、季度和股票代码查询\n- 包含每股收益、营业收入、净利润等关键财务指标\n- 提供同比和环比增长数据\n- 高效、稳定的数据获取体验\n- 毫秒级查询性能\n- 围绕“A 股业绩报表数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股业绩报表数据”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/performance-statement",
        "operationId": "get_performance_statement",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/performance-statement"
        },
        "x-gugudata-api-identity": "performance-statement",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票名称"
                        },
                        "EarningsPerShare": {
                          "type": "number",
                          "description": "每股收益"
                        },
                        "Revenue": {
                          "type": "number",
                          "description": "营业收入"
                        },
                        "RevenueYoY": {
                          "type": "number",
                          "description": "营业收入同比增长"
                        },
                        "RevenueQoQ": {
                          "type": "number",
                          "description": "营业收入环比增长"
                        },
                        "NetProfit": {
                          "type": "number",
                          "description": "净利润"
                        },
                        "NetProfitYoY": {
                          "type": "number",
                          "description": "净利润同比增长"
                        },
                        "NetProfitQoQ": {
                          "type": "number",
                          "description": "净利润环比增长"
                        },
                        "NetAssetsPerShare": {
                          "type": "number",
                          "description": "每股净资产"
                        },
                        "ROE": {
                          "type": "number",
                          "description": "净资产收益率"
                        },
                        "OperatingCashFlowPerShare": {
                          "type": "number",
                          "description": "每股经营现金流量"
                        },
                        "GrossMargin": {
                          "type": "number",
                          "description": "销售毛利率"
                        },
                        "Industry": {
                          "type": "string",
                          "description": "所处行业"
                        },
                        "LastAnnouncementDate": {
                          "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/stock/cn/performance-statement/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "year",
            "in": "query",
            "required": true,
            "description": "年份",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 2024
          },
          {
            "name": "quarter",
            "in": "query",
            "required": true,
            "description": "季度，可选值：q1, q2, q3, q4",
            "schema": {
              "type": "string",
              "enum": [
                "q1",
                "q2",
                "q3",
                "q4"
              ]
            },
            "example": "q1"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "股票代码，例如 600686",
            "schema": {
              "type": "string"
            },
            "example": "SYMBOL"
          }
        ]
      }
    },
    "/stock/cn/preopen": {
      "get": {
        "summary": "A 股当日分时含盘前数据",
        "description": "支持实时盘前数据\n接口标签：股票、A股、分时数据、当日交易分时数据、分钟级数据\n接口特性：\n- 支持所有 A 股数据查询\n- 当日实时分钟级交易数据\n- 支持分钟级盘前实时数据查询\n- 毫秒级查询性能\n- 围绕“A 股当日分时含盘前数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股当日分时含盘前数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnpreopen",
        "operationId": "get_stockcnpreopen",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnpreopen"
        },
        "x-gugudata-api-identity": "stockcnpreopen",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码"
                        },
                        "TimeKey": {
                          "type": "number",
                          "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": "成交额，单位：元"
                        },
                        "Latest": {
                          "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/preopen/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "股票编码，如: 600000",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/stock/cn/realtime": {
      "get": {
        "summary": "A 股实时行情数据",
        "description": "所有A股实时交易行情数据\n接口标签：股票、A股、实时数据、A股实时数据、支持代码筛选\n接口特性：\n- 支持所有 A 股实时交易数据查询\n- 单次可同时查询多支股票\n- 包含 A 股实时交易多项指标数据\n- 毫秒级查询性能\n- 围绕“A 股实时行情数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股实时行情数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnrealtime",
        "operationId": "get_stockcnrealtime",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnrealtime"
        },
        "x-gugudata-api-identity": "stockcnrealtime",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "A 股股票代码"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票名称"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "最新价，单位：元"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅，单位：%"
                        },
                        "ChangeAmount": {
                          "type": "number",
                          "description": "涨跌额，单位：元"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量，单位：手"
                        },
                        "TradingAmount": {
                          "type": "number",
                          "description": "成交额，单位：元"
                        },
                        "Swing": {
                          "type": "number",
                          "description": "振幅，单位：%"
                        },
                        "High": {
                          "type": "number",
                          "description": "最高，单位：元"
                        },
                        "Low": {
                          "type": "number",
                          "description": "最低，单位：元"
                        },
                        "Open": {
                          "type": "number",
                          "description": "今日开盘价，单位：元"
                        },
                        "PreClose": {
                          "type": "number",
                          "description": "昨收价，单位：元"
                        },
                        "QuantityRatio": {
                          "type": "number",
                          "description": "量比"
                        },
                        "TurnoverRate": {
                          "type": "number",
                          "description": "换手率，单位：%"
                        },
                        "PERatioDynamic": {
                          "type": "number",
                          "description": "市盈率-动态"
                        },
                        "PBRatio": {
                          "type": "number",
                          "description": "市净率"
                        },
                        "IsLimitUp": {
                          "type": "boolean",
                          "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/realtime/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "默认不传递或传递空值，则获取所有 A 股实时交易数据（需要注意在获取全量数据时，数据量传输对接口调用性能的影响）。支持传递单支或多支 A 股股票代码进行筛选，多支股票用逗号隔开，格式为: 600031,688819。具体值参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a>",
            "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"
          }
        ]
      }
    },
    "/stock/cn/realtimeindex": {
      "get": {
        "summary": "A 股股票指数实时数据",
        "description": "查询 A 股股票指数实时行情数据\n接口标签：股票、A股、指数、实时数据、股票指数实时数据、支持代码筛选\n接口特性：\n- 仅用于查询指数实时行情，不用于查询个股实时行情\n- symbol 不传时返回当前可用指数列表，传多个指数代码时使用英文逗号分隔，单次最多 10 个\n- 返回最新价、涨跌额、涨跌幅、昨收、开盘、最高、最低、成交量和成交额等行情指标\n- 适合指数行情看板、市场概览、指数监控和行情数据同步等场景\n- 围绕“A 股股票指数实时数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股股票指数实时数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnrealtimeindex",
        "operationId": "get_stockcnrealtimeindex",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnrealtimeindex"
        },
        "x-gugudata-api-identity": "stockcnrealtimeindex",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票指数代码。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票指数名称。"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "最新价。"
                        },
                        "ChangeAmount": {
                          "type": "number",
                          "description": "涨跌额。"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅，单位：%。"
                        },
                        "PreClose": {
                          "type": "number",
                          "description": "昨收价。"
                        },
                        "Open": {
                          "type": "number",
                          "description": "今日开盘价。"
                        },
                        "High": {
                          "type": "number",
                          "description": "当日最高价。"
                        },
                        "Low": {
                          "type": "number",
                          "description": "当日最低价。"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量。"
                        },
                        "TradingAmount": {
                          "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/realtimeindex/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "指数代码筛选参数，支持单个或多个指数代码，多个代码使用英文逗号分隔，单次最多 10 个；示例：sh000001,sh000002。具体值参见 <a href='/enum/stockcnindex/symbols' target='_blank'>中国股票指数代码参数枚举页面</a>。",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockcnindex/symbols"
          }
        ]
      }
    },
    "/stock/cn/stock-bid-ask": {
      "get": {
        "summary": "A 股买卖盘口数据",
        "description": "不同价格级别买卖数量和报价\n接口标签：股票、A股、买卖盘口、股票交易数据、盘口分析\n接口特性：\n- 实时更新股票盘口数据\n- 支持 A 股所有股票\n- 支持按股票代码查询\n- 高效、稳定的数据获取体验\n- 毫秒级查询性能\n- 围绕“A 股买卖盘口数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股买卖盘口数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n详情页：https://www.gugudata.com/api/details/stockcnbidask",
        "operationId": "get_stockcnbidask",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnbidask"
        },
        "x-gugudata-api-identity": "stockcnbidask",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码"
                        },
                        "Sell5": {
                          "type": "number",
                          "description": "卖5"
                        },
                        "Sell5Volume": {
                          "type": "number",
                          "description": "卖5数量"
                        },
                        "Sell4": {
                          "type": "number",
                          "description": "卖4"
                        },
                        "Sell4Volume": {
                          "type": "number",
                          "description": "卖4数量"
                        },
                        "Sell3": {
                          "type": "number",
                          "description": "卖3"
                        },
                        "Sell3Volume": {
                          "type": "number",
                          "description": "卖3数量"
                        },
                        "Sell2": {
                          "type": "number",
                          "description": "卖2"
                        },
                        "Sell2Volume": {
                          "type": "number",
                          "description": "卖2数量"
                        },
                        "Sell1": {
                          "type": "number",
                          "description": "卖1"
                        },
                        "Sell1Volume": {
                          "type": "number",
                          "description": "卖1数量"
                        },
                        "Buy1": {
                          "type": "number",
                          "description": "买1"
                        },
                        "Buy1Volume": {
                          "type": "number",
                          "description": "买1数量"
                        },
                        "Buy2": {
                          "type": "number",
                          "description": "买2"
                        },
                        "Buy2Volume": {
                          "type": "number",
                          "description": "买2数量"
                        },
                        "Buy3": {
                          "type": "number",
                          "description": "买3"
                        },
                        "Buy3Volume": {
                          "type": "number",
                          "description": "买3数量"
                        },
                        "Buy4": {
                          "type": "number",
                          "description": "买4"
                        },
                        "Buy4Volume": {
                          "type": "number",
                          "description": "买4数量"
                        },
                        "Buy5": {
                          "type": "number",
                          "description": "买5"
                        },
                        "Buy5Volume": {
                          "type": "number",
                          "description": "买5数量"
                        }
                      },
                      "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/stock-bid-ask/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "股票代码，例如 600000",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_SYMBOL"
          }
        ]
      }
    },
    "/stock/cn/stock-cash-flow": {
      "get": {
        "summary": "A 股个股资金流",
        "description": "交易日多档资金流明细\n接口标签：股票、A股、资金流、交易日资金流、最近 30 个交易日、多档订单资金\n接口特性：\n- 支持按 6 位 A 股代码查询最近 1~30 个已完成交易日的个股资金流明细\n- 返回收盘价、涨跌幅以及主力、超大单、大单、中单和小单的净流入金额与占比\n- 本接口提供交易日汇总数据，不提供盘中实时资金流\n- 盘中成交和分钟行情可分别使用 A 股分笔实时交易数据、A 股分时交易数据接口\n- 使用 limit 控制返回数量，默认返回 30 条\n- 资金流金额以元计，正数表示净流入、负数表示净流出，比例以百分比计\n- 结果按交易日升序排列；非交易日或当日数据尚未形成时，返回最近已有交易日数据\n- 适合股票详情页、资金流趋势图、主力资金监控、选股辅助和投研看板\n详情页：https://www.gugudata.com/api/details/stockcncashflow",
        "operationId": "get_stockcncashflow",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcncashflow"
        },
        "x-gugudata-api-identity": "stockcncashflow",
        "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": "服务端识别的本次业务参数摘要，例如 symbol=600036&limit=30；不包含 APPKEY。"
                        },
                        "StatusCode": {
                          "type": "integer",
                          "format": "int32",
                          "description": "业务状态码。100 表示成功；101 表示参数错误；102 表示请求频率受限；103 表示账号欠费；104 表示 APPKEY 无效；110 表示接口或上游服务异常。"
                        },
                        "StatusDescription": {
                          "type": "string",
                          "description": "业务状态说明。请求失败时应结合 StatusCode 判断参数、鉴权、额度或服务异常。"
                        },
                        "ResponseDateTime": {
                          "type": "string",
                          "description": "服务端生成响应的北京时间，格式为 yyyy-MM-dd HH:mm:ss.fff。"
                        },
                        "DataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "本次 Data 数组实际返回的记录条数，最大不超过 limit；不是该股票全部历史资金流记录数。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "Symbol": {
                          "type": "string",
                          "description": "当前记录所属的 6 位 A 股股票代码，保留前导零。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票简称，用于结果展示和代码核对。"
                        },
                        "DateKey": {
                          "type": "string",
                          "description": "资金流所属交易日对应的 13 位毫秒时间戳字符串；每条记录代表一个已完成交易日，不是盘中实时数据。时间点为该日期 00:00:00 UTC，例如 1783641600000 对应 2026-07-10。"
                        },
                        "Close": {
                          "type": "number",
                          "description": "对应 DateKey 交易日的收盘价，不是请求时刻的实时成交价。"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "对应交易日的涨跌幅，单位为百分比，例如 1.25 表示上涨 1.25%。"
                        },
                        "MainNetInflowAmount": {
                          "type": "number",
                          "description": "主力资金净流入金额，单位为元；正数表示净流入，负数表示净流出。"
                        },
                        "MainNetInflowRatio": {
                          "type": "number",
                          "description": "主力资金净流入占比，单位为百分比；正负方向与净流入金额一致。"
                        },
                        "SuperLargeNetInflowAmount": {
                          "type": "number",
                          "description": "超大单资金净流入金额，单位为元；正数为净流入，负数为净流出。"
                        },
                        "SuperLargeNetInflowRatio": {
                          "type": "number",
                          "description": "超大单资金净流入占比，单位为百分比。"
                        },
                        "LargeNetInflowAmount": {
                          "type": "number",
                          "description": "大单资金净流入金额，单位为元；正数为净流入，负数为净流出。"
                        },
                        "LargeNetInflowRatio": {
                          "type": "number",
                          "description": "大单资金净流入占比，单位为百分比。"
                        },
                        "MediumNetInflowAmount": {
                          "type": "number",
                          "description": "中单资金净流入金额，单位为元；正数为净流入，负数为净流出。"
                        },
                        "MediumNetInflowRatio": {
                          "type": "number",
                          "description": "中单资金净流入占比，单位为百分比。"
                        },
                        "SmallNetInflowAmount": {
                          "type": "number",
                          "description": "小单资金净流入金额，单位为元；正数为净流入，负数为净流出。"
                        },
                        "SmallNetInflowRatio": {
                          "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/stock-cash-flow/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "必填。受支持市场的 6 位 A 股股票代码，保留前导零，例如 600036、000001、300750 或 430047；不接受市场前缀、证券简称、逗号分隔批量代码或 B 股代码。",
            "schema": {
              "type": "string"
            },
            "example": 600036
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "可选。返回最近多少个交易日的资金流记录，取值范围 1~30，默认 30；结果按交易日升序排列，因此最后一条为本次返回范围内的最新交易日。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 30
          }
        ]
      }
    },
    "/stock/cn/stock-cash-flow-rank": {
      "get": {
        "summary": "A 股个股资金流排行",
        "description": "A 股资金流排行洞察\n接口标签：股票、A股、多时间区间、全量A股数据\n接口特性：\n- 支持按今日、3 日、5 日、10 日等时间指标查询 A 股资金流排行\n- 返回最新价、涨跌幅、主力资金、超大单、大单、中单和小单资金流指标\n- 支持分页查询，适合构建资金流排行榜和市场资金监控看板\n- 适合股票筛选、主力资金跟踪、市场热点分析和投研辅助等场景\n- 围绕“A 股个股资金流排行”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股个股资金流排行”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcncashflowrank",
        "operationId": "get_stockcncashflowrank",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcncashflowrank"
        },
        "x-gugudata-api-identity": "stockcncashflowrank",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票名称。"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "最新价。"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅，单位：%。"
                        },
                        "MainNetInflowAmount": {
                          "type": "number",
                          "description": "主力净流入金额。"
                        },
                        "MainNetInflowRatio": {
                          "type": "number",
                          "description": "主力净流入占比，单位：%。"
                        },
                        "SuperLargeNetInflowAmount": {
                          "type": "number",
                          "description": "超大单净流入金额。"
                        },
                        "SuperLargeNetInflowRatio": {
                          "type": "number",
                          "description": "超大单净流入占比，单位：%。"
                        },
                        "LargeNetInflowAmount": {
                          "type": "number",
                          "description": "大单净流入金额。"
                        },
                        "LargeNetInflowRatio": {
                          "type": "number",
                          "description": "大单净流入占比，单位：%。"
                        },
                        "MediumNetInflowAmount": {
                          "type": "number",
                          "description": "中单净流入金额。"
                        },
                        "MediumNetInflowRatio": {
                          "type": "number",
                          "description": "中单净流入占比，单位：%。"
                        },
                        "SmallNetInflowAmount": {
                          "type": "number",
                          "description": "小单净流入金额。"
                        },
                        "SmallNetInflowRatio": {
                          "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/stock-cash-flow-rank/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "indicator",
            "in": "query",
            "required": true,
            "description": "时间指标，可选值：今日、3日、5日、10日。",
            "schema": {
              "type": "string",
              "enum": [
                "今日",
                "3日",
                "5日",
                "10日"
              ]
            },
            "example": "今日"
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "分页页码，从 1 开始，默认 1。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页数量，默认 100，最大 100。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 100
          }
        ]
      }
    },
    "/stock/cn/stock-limit-up": {
      "get": {
        "summary": "A 股涨停板实时数据",
        "description": "所有A股涨停板实时数据\n接口标签：股票、A股、涨停数据、A股涨停数据、实时数据\n接口特性：\n- 支持所有 A 股涨停板实时数据查询\n- 包含 A 股实时交易多项指标数据\n- 毫秒级查询性能\n- 围绕“A 股涨停板实时数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股涨停板实时数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n- 支持按股票、指数、交易日或指标维度组织结果\n详情页：https://www.gugudata.com/api/details/stockcnlimitup",
        "operationId": "get_stockcnlimitup",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnlimitup"
        },
        "x-gugudata-api-identity": "stockcnlimitup",
        "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": {
                        "DateKey": {
                          "type": "string",
                          "description": "数据日期，格式：YYYYMMDD"
                        },
                        "Code": {
                          "type": "string",
                          "description": "A 股股票代码"
                        },
                        "Name": {
                          "type": "string",
                          "description": "股票名称"
                        },
                        "ChangeRate": {
                          "type": "number",
                          "description": "涨跌幅，单位：%"
                        },
                        "LatestPrice": {
                          "type": "number",
                          "description": "最新价，单位：元"
                        },
                        "TransactionAmount": {
                          "type": "number",
                          "description": "成交额，单位：元"
                        },
                        "CirculatingMarketValue": {
                          "type": "number",
                          "description": "流通市值，单位：元"
                        },
                        "TotalMarketValue": {
                          "type": "number",
                          "description": "总市值，单位：元"
                        },
                        "TurnoverRate": {
                          "type": "number",
                          "description": "换手率，单位：%"
                        },
                        "SealingFunds": {
                          "type": "number",
                          "description": "封单金额，单位：元"
                        },
                        "FirstSealingTime": {
                          "type": "string",
                          "description": "首次封板时间，格式：HHMMSS"
                        },
                        "LastSealingTime": {
                          "type": "string",
                          "description": "最后封板时间，格式：HHMMSS"
                        },
                        "BoardBreakingTimes": {
                          "type": "integer",
                          "format": "int32",
                          "description": "开板次数"
                        },
                        "LimitUpStatistics": {
                          "type": "string",
                          "description": "涨停统计"
                        },
                        "ConsecutiveBoards": {
                          "type": "integer",
                          "format": "int32",
                          "description": "连板数"
                        },
                        "Industry": {
                          "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/stock/cn/stock-limit-up/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/stock/cn/stockcnperminute": {
      "get": {
        "summary": "A 股分时交易数据",
        "description": "实时A股分时交易数据\n接口标签：股票、A股、分时数据、分钟级交易数据、多时间段区间\n接口特性：\n- 支持所有 A 股分时交易数据查询\n- 支持 1、5、15、30、60 分钟交易区间，注意: 只返回近期的交易数据\n- 同时参数支持获取历史数据\n- 毫秒级查询性能\n- 围绕“A 股分时交易数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股分时交易数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnperminute",
        "operationId": "get_stockcnperminute",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnperminute"
        },
        "x-gugudata-api-identity": "stockcnperminute",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "A 股股票代码"
                        },
                        "TimeKey": {
                          "type": "number",
                          "description": "交易时间"
                        },
                        "Open": {
                          "type": "number",
                          "description": "今日开盘价，单位：元"
                        },
                        "Close": {
                          "type": "number",
                          "description": "昨收价，单位：元"
                        },
                        "High": {
                          "type": "number",
                          "description": "最高，单位：元"
                        },
                        "Low": {
                          "type": "number",
                          "description": "最低，单位：元"
                        },
                        "ChangePercent": {
                          "type": "number",
                          "description": "涨跌幅 ，单位：%"
                        },
                        "ChangeAmount": {
                          "type": "number",
                          "description": "涨跌额 ，单位：元"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量，单位：手"
                        },
                        "TradingAmount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "成交额 ，单位：元，较远的历史数据不返回此值"
                        },
                        "Swing": {
                          "type": "number",
                          "description": "振幅，单位：%"
                        },
                        "TurnoverRate": {
                          "type": "number",
                          "description": "换手率，单位：%"
                        },
                        "Latest": {
                          "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/stockcnperminute/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "传递单支股票代码，如: 600031。可通过前置接口或参见 <a href='/enum/stockcn/symbols' target='_blank'>A 股股票代码参数枚举页面</a>",
            "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": "交易开始时间，参数格式为: 2021-01-01 09:00:00",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "enddate",
            "in": "query",
            "required": true,
            "description": "交易结束时间，参数格式为: 2021-01-01 09:00:00，与开始时间最大时间跨度支持 366 个自然日，获取全量数据请分批获取，数据量较大，请保持合理的请求频率",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "period",
            "in": "query",
            "required": false,
            "description": "交易数据时间区间，可选时间区间价参数为: 1|5|15|30|60 (分钟)， 其中 1 分钟时间区间交易数据仅返回近 5 个交易日不复权数据，其他时间区间返回近期的交易数据。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 5
          },
          {
            "name": "adjust",
            "in": "query",
            "required": false,
            "description": "查询前复权、后复权数据，如果传递参数值为 pre，那么返回前复权数据（所有数据进行了前复权）；如果传递参数值为 after，那么返回后复权数据；默认值为空或不传递，返回未复权数据",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/stock/cn/ticks": {
      "get": {
        "summary": "A 股分笔实时交易数据",
        "description": "A 股逐笔成交明细追踪\n接口标签：股票、A股、分笔数据、支持全量 A 股、当日数据\n接口特性：\n- 支持 A 股股票当日分笔实时成交明细查询\n- symbol 建议传入带市场前缀的股票代码，例如 sh600000、sz000001\n- 返回成交时间、价格、价格变化、成交量、成交额和成交方向\n- 适合逐笔成交列表、盘口监控、短线交易分析和成交行为研究等场景\n- 围绕“A 股分笔实时交易数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股分笔实时交易数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcnticks",
        "operationId": "get_stockcnticks",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnticks"
        },
        "x-gugudata-api-identity": "stockcnticks",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码。"
                        },
                        "TimeKey": {
                          "type": "string",
                          "description": "成交时间。"
                        },
                        "Price": {
                          "type": "number",
                          "description": "成交价格。"
                        },
                        "PriceChange": {
                          "type": "number",
                          "description": "相对上一笔或上一成交价的价格变化。"
                        },
                        "TradingVolume": {
                          "type": "number",
                          "description": "成交量。"
                        },
                        "TradingAmount": {
                          "type": "number",
                          "description": "成交额。"
                        },
                        "Type": {
                          "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/stock/cn/ticks/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "A 股股票代码，建议使用带市场前缀代码，例如 sh600000、sz000001。",
            "schema": {
              "type": "string"
            },
            "example": "sh600000"
          }
        ]
      }
    },
    "/stock/cn/trade_calendar": {
      "get": {
        "summary": "A 股交易日历",
        "description": "全量 A 股交易日历\n接口标签：股票、A股、1990 年开市开始、完整交易日历\n接口特性：\n- 支持所有 A 股交易日历\n- 从 A 股开市交易至本年度结束日历数据\n- 后续年份交易日历持续更新\n- 毫秒级查询性能\n- 围绕“A 股交易日历”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股交易日历”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockcntradecalendar",
        "operationId": "get_stockcntradecalendar",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcntradecalendar"
        },
        "x-gugudata-api-identity": "stockcntradecalendar",
        "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": "string"
                      },
                      "description": "从 1990/12/19 开始至今的交易日历数据"
                    }
                  },
                  "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/trade_calendar/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/stock/cnsymbols": {
      "get": {
        "summary": "查询 A 股股票代码列表数据，支持分页查询",
        "description": "包含股票编码、股票名称、股票中文名称\n仅返回当前有效代码，历史代码仍可用于已支持的历史数据查询。\n接口标签：股票、A股、实时数据、A股实时数据、支持代码筛选\n详情页：https://www.gugudata.com/api/details/stockcnrealtime",
        "operationId": "get_get_stock_cnsymbols",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockcnrealtime"
        },
        "x-gugudata-api-identity": "stockcnrealtime",
        "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": "stockcnrealtime",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/stockcnrealtime",
        "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": "第几页"
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            },
            "example": "每页返回数量，最大 50 条"
          }
        ]
      }
    },
    "/stock/hk/annualreport": {
      "get": {
        "summary": "港股历年三大财务报表",
        "description": "历年所有财报数据\n接口标签：股票、港股、全量港股数据、最全三大财报数据\n接口特性：\n- 支持所有港股全量三大财报数据查询\n- 分别包括财报基本面、资产负债表、利润表、现金流量表数据\n- 返回 70 多项财务指标\n- 多数据源清洗整合，百万级数据毫秒级返回\n- 围绕“港股历年三大财务报表”提供标准化能力，便于快速接入现有业务\n- 适合将“港股历年三大财务报表”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/hkannualreport",
        "operationId": "get_hkannualreport",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/hkannualreport"
        },
        "x-gugudata-api-identity": "hkannualreport",
        "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": "资产负债表数据，动态输出。"
                              },
                              "利润表": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "利润表数据，动态输出。"
                              },
                              "现金流量表": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                },
                                "description": "现金流量表数据，动态输出。"
                              }
                            }
                          },
                          "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/hk/annualreport/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "支持传递单个港股股票代码进行筛选，如：00012。具体值参见 <a href='/enum/stockhk/symbols' target='_blank'>港股股票代码参数枚举页面</a>",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockhk/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockhk/symbols",
            "example": "YOUR_VALUE"
          },
          {
            "name": "type",
            "in": "query",
            "required": true,
            "description": "三大财报类型，可选值为：资产负债表|利润表|现金流量表，传递空值，获取财报基本面数据。",
            "schema": {
              "type": "string",
              "enum": [
                "资产负债表",
                "利润表",
                "现金流量表"
              ]
            }
          },
          {
            "name": "indicator",
            "in": "query",
            "required": true,
            "description": "财报时间区间类型，可选值为：年度|报告期",
            "schema": {
              "type": "string",
              "enum": [
                "年度",
                "报告期"
              ]
            }
          }
        ]
      }
    },
    "/stock/hk/basicinfo": {
      "get": {
        "summary": "港股基础信息数据",
        "description": "港股基础资料与估值概览\n接口标签：股票、港股、港指市值数据、所有港股数据\n接口特性：\n- 支持分页查询港股基础资料\n- keywords 可按股票代码或名称筛选\n- 返回股票代码、名称、最新价、市值和市盈率等常用字段\n- 适合港股列表、搜索补全、股票资料页和港股基础库建设等场景\n- 围绕“港股基础信息数据”提供标准化能力，便于快速接入现有业务\n- 适合将“港股基础信息数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stockhkbasicinfo",
        "operationId": "get_stockhkbasicinfo",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockhkbasicinfo"
        },
        "x-gugudata-api-identity": "stockhkbasicinfo",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每秒请求不能超过100次"
          },
          {
            "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "港股股票代码。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "股票名称。"
                        },
                        "Latest": {
                          "type": "number",
                          "description": "最新价。"
                        },
                        "MarketValue": {
                          "type": "number",
                          "description": "总市值。"
                        },
                        "PERatio": {
                          "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/hk/basicinfo/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": "pageindex",
            "in": "query",
            "required": false,
            "description": "分页页码，从 1 开始。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "每页数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          }
        ]
      }
    },
    "/stock/hk/bulletin": {
      "get": {
        "summary": "港股上市公司公告",
        "description": "港股公告检索与摘要归档\n接口标签：股票、港股、10年公告数据、详细公告数据\n接口特性：\n- 支持港股上市公司公告查询，symbol 为必填港股代码\n- 支持 language=en 或 zh 查询英文或繁体中文公告\n- 支持 sortorder=desc 或 asc 控制公告发布时间排序\n- 可通过 reporttype=annual/interim 与 year 直达查询指定年度年报或中报 PDF\n- 返回公告文件链接，PDF 等公告原始文件可直接下载\n- 围绕“港股上市公司公告”提供标准化能力，便于快速接入现有业务\n- 适合将“港股上市公司公告”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n详情页：https://www.gugudata.com/api/details/stockhkbulletin",
        "operationId": "get_stockhkbulletin",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockhkbulletin"
        },
        "x-gugudata-api-identity": "stockhkbulletin",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "港股股票代码。"
                        },
                        "StockName": {
                          "type": "string",
                          "description": "港股股票名称。"
                        },
                        "Title": {
                          "type": "string",
                          "description": "公告标题。"
                        },
                        "ShortText": {
                          "type": "string",
                          "description": "公告摘要或公告分类文本。"
                        },
                        "LongText": {
                          "type": "string",
                          "description": "公告详情文本。"
                        },
                        "FileSize": {
                          "type": "string",
                          "description": "公告文件大小。"
                        },
                        "FileType": {
                          "type": "string",
                          "description": "公告文件类型，例如 PDF。"
                        },
                        "FileLink": {
                          "type": "string",
                          "description": "公告文件下载链接。"
                        },
                        "BulletinDateTime": {
                          "type": "string",
                          "description": "公告发布时间，格式 yyyy/MM/dd HH:mm。"
                        },
                        "UniqueId": {
                          "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/stock/hk/bulletin/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": true,
            "description": "港股股票代码，必填，示例：00814、01378。具体值参见 <a href='/enum/stockhk/symbols' target='_blank'>港股股票代码参数枚举页面</a>。",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockhk/symbols"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/enum/stockhk/symbols"
          },
          {
            "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
          },
          {
            "name": "language",
            "in": "query",
            "required": false,
            "description": "公告语言，可选 en 或 zh；en 表示英文公告，zh 表示繁体中文公告，默认 en。",
            "schema": {
              "type": "string"
            },
            "example": "en"
          },
          {
            "name": "sortorder",
            "in": "query",
            "required": false,
            "description": "公告发布时间排序方式，可选 desc 或 asc；desc 表示倒序，asc 表示正序，默认 desc。",
            "schema": {
              "type": "string"
            },
            "example": "desc"
          },
          {
            "name": "reporttype",
            "in": "query",
            "required": false,
            "description": "报告类型过滤，可选 annual 或 interim；annual 表示年报 PDF，interim 表示中报 PDF。不传时返回普通公告列表。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "报告所属年度，格式为 4 位年份。例如 year=2025 表示查询 2025 年报或 2025 中报，不按公告发布时间年份过滤。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          }
        ]
      }
    },
    "/stock/hksymbols": {
      "get": {
        "summary": "查询港股股票代码列表数据，支持分页查询",
        "description": "包含股票编码、股票名称、股票中文名称\n仅返回当前有效代码，历史代码仍可用于已支持的历史数据查询。\n接口标签：股票、港股、全量港股数据、最全三大财报数据\n详情页：https://www.gugudata.com/api/details/hkannualreport",
        "operationId": "get_get_stock_hksymbols",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/hkannualreport"
        },
        "x-gugudata-api-identity": "hkannualreport",
        "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": "hkannualreport",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/hkannualreport",
        "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": "第几页"
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            },
            "example": "每页返回数量，最大 50 条"
          }
        ]
      }
    },
    "/stock/kcb": {
      "get": {
        "summary": "A 股科创板历史行情数据",
        "description": "全量科创板历史行情\n接口标签：股票、A股、科创板、全量历史数据、支持代码筛选\n接口特性：\n- 支持所有科创板历史交易数据查询\n- 包含科创板交易多项指标数据\n- 毫秒级查询性能\n- 围绕“A 股科创板历史行情数据”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股科创板历史行情数据”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n- 支持按股票、指数、交易日或指标维度组织结果\n详情页：https://www.gugudata.com/api/details/stockkcb",
        "operationId": "get_stockkcb",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stockkcb"
        },
        "x-gugudata-api-identity": "stockkcb",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "科创板股票代码"
                        },
                        "Open": {
                          "type": "number",
                          "description": "开盘价，单位：元"
                        },
                        "Close": {
                          "type": "number",
                          "description": "收盘价，单位：元"
                        },
                        "High": {
                          "type": "number",
                          "description": "最高价，单位：元"
                        },
                        "Low": {
                          "type": "number",
                          "description": "最低价，单位：元"
                        },
                        "Volume": {
                          "type": "number",
                          "description": "成交量，单位：股"
                        },
                        "AfterVolume": {
                          "type": "number",
                          "description": "盘后量"
                        },
                        "AfterAmount": {
                          "type": "number",
                          "description": "盘后额"
                        },
                        "TradableEquity": {
                          "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/kcb/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "symbol",
            "in": "query",
            "required": false,
            "description": "支持传递单支科创板股票代码进行筛选，格式为: sh688008。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "begindate",
            "in": "query",
            "required": true,
            "description": "股票交易开始时间，格式为 20200101",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "enddate",
            "in": "query",
            "required": true,
            "description": "股票交易结束时间，格式为 20200101，与开始时间最大时间跨度支持 3660 个自然日，获取全量数据请分批获取，数据量较大，请保持合理的请求频率",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "adjust",
            "in": "query",
            "required": false,
            "description": "查询前复权、后复权数据，如果传递参数值为 pre，那么返回前复权数据（所有数据进行了前复权）；如果传递参数值为 after，那么返回后复权数据；默认值为空或不传递，返回未复权数据",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/stock/symbols": {
      "get": {
        "summary": "A 股股票代码",
        "description": "实时更新股票代码列表。仅展示当前有效代码，历史代码仍可用于已支持的历史数据查询。\n接口标签：股票、A股、实时数据、多交易所数据\n接口特性：\n- 目前支持所有 A 股股票代码列表查询\n- 无需自己维护数据源，我们提供实时列表数据\n- 包含 A 股所有交易所的股票代码列表\n- 毫秒级查询性能\n- 围绕“A 股股票代码”提供标准化能力，便于快速接入现有业务\n- 适合将“A 股股票代码”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n- 可与股票代码、交易日历、资金流和财务数据接口组合\n详情页：https://www.gugudata.com/api/details/stocksymbols",
        "operationId": "get_stocksymbols",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stocksymbols"
        },
        "x-gugudata-api-identity": "stocksymbols",
        "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": {
                        "Symbol": {
                          "type": "string",
                          "description": "股票代码"
                        },
                        "SymbolName": {
                          "type": "string",
                          "description": "股票名称"
                        },
                        "SymbolType": {
                          "type": "string",
                          "description": "股票类型，A：A股"
                        }
                      },
                      "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/symbols/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "stockType",
            "in": "query",
            "required": true,
            "description": "股票类型，A：A股",
            "schema": {
              "type": "string"
            },
            "example": "A"
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": true,
            "description": "分页参数，页码",
            "schema": {
              "type": "number"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": true,
            "description": "分页参数，每页条数，最大值：100，若传递 0 则返回所有数据",
            "schema": {
              "type": "number"
            },
            "example": 0
          }
        ]
      }
    },
    "/text/chinesepinyin": {
      "post": {
        "summary": "中文转拼音",
        "description": "多音字智能解析\n接口标签：文本处理、毫秒级响应、拼音标准格式\n接口特性：\n- 多音字智能解析\n- 拼音标准格式\n- 毫秒级响应性能\n- 围绕“中文转拼音”提供标准化能力，便于快速接入现有业务\n- 适合将“中文转拼音”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n- 支持将文本处理结果接入编辑器、客服系统和知识库\n详情页：https://www.gugudata.com/api/details/chinesepinyin",
        "operationId": "post_chinesepinyin",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/chinesepinyin"
        },
        "x-gugudata-api-identity": "chinesepinyin",
        "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": "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/text/chinesepinyin/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": "需要转拼音的中文文本"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/chinesepoem": {
      "get": {
        "summary": "唐诗宋词大全",
        "description": "支持 40 万数据全文检索\n接口标签：基础数据、唐宋诗词全量数据、多种检索条件\n接口特性：\n- 中文全数量级唐诗宋诗宋词数据\n- 关键字可对标题、作者与内容进行模糊匹配\n- 总计近 40 万条数据\n- 数据持续更新与维护\n- 围绕“唐诗宋词大全”提供标准化能力，便于快速接入现有业务\n- 适合将“唐诗宋词大全”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/chinesepoem",
        "operationId": "get_chinesepoem",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/chinesepoem"
        },
        "x-gugudata-api-identity": "chinesepoem",
        "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": {
                        "Title": {
                          "type": "string",
                          "description": "诗歌标题或宋词词牌名"
                        },
                        "Author": {
                          "type": "string",
                          "description": "作者名"
                        },
                        "Content": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "诗歌或词的内容，格式为 string 数组"
                        },
                        "Type": {
                          "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/text/chinesepoem/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"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": true,
            "description": "分页参数，每页总条数，取值范围在 1 ~ 20 之间",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          },
          {
            "name": "pagenumber",
            "in": "query",
            "required": true,
            "description": "分页参数，第几页",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "数据分类，可选参数为（tang, song, ci）。唐诗: tang | 宋诗: song | 宋词: ci，不传递或空值则不进行过滤",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "searchtype",
            "in": "query",
            "required": false,
            "description": "关键字条件匹配的内容，可选参数为（title, author, content, all）。标题或词牌名: title | 作者: author | 诗歌或词的内容: content | 匹配以上所有: all，不传递则默认值为 all",
            "schema": {
              "type": "string"
            },
            "example": "all"
          }
        ]
      }
    },
    "/text/correct": {
      "post": {
        "summary": "NLP 中文智能纠错",
        "description": "专注于中文语句智能纠错\n接口标签：文本处理、NLP、人工智能、基于 NLP、多模型参与纠错\n接口特性：\n- 秒级 NLP 智能纠错性能\n- NLP 加载多个模型进行纠错处理\n- 返回纠正字符以及对应位置索引\n- 底层模型以及语料库持续更新集成中\n- 单次请求建议控制在 300 字以内，可分段处理或改用多语言文本 AI 纠错格式化接口\n- 围绕“NLP 中文智能纠错”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 中文智能纠错”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n详情页：https://www.gugudata.com/api/details/nlpcorrect",
        "operationId": "post_nlpcorrect",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/nlpcorrect"
        },
        "x-gugudata-api-identity": "nlpcorrect",
        "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": {
                        "CorrectedContent": {
                          "type": "string",
                          "description": "纠正后中文文本"
                        },
                        "Corrects": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "additionalProperties": true
                          },
                          "description": "返回对应纠正操作数组，SourceWord: 原字符, CorrectedWord: 纠正后字符, StartIndex: 字符起始索引, EndIndex: 字符结束索引"
                        }
                      },
                      "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/text/correct/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": "文本内容"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/couplet": {
      "get": {
        "summary": "百万中国对联数据",
        "description": "支持全文检索级别\n接口标签：基础数据、百万级数据、支持全文数据检索\n接口特性：\n- 中文全数量级历史对联数据\n- 百万级数据\n- 数据持续更新与维护\n- 围绕“百万中国对联数据”提供标准化能力，便于快速接入现有业务\n- 适合将“百万中国对联数据”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n- 支持将文本处理结果接入编辑器、客服系统和知识库\n详情页：https://www.gugudata.com/api/details/couplet",
        "operationId": "get_couplet",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/couplet"
        },
        "x-gugudata-api-identity": "couplet",
        "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": {
                        "First": {
                          "type": "string",
                          "description": "上联"
                        },
                        "Second": {
                          "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/text/couplet/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"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": true,
            "description": "分页参数，每页总条数，取值范围在 1 ~ 20 之间",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          },
          {
            "name": "pagenumber",
            "in": "query",
            "required": true,
            "description": "分页参数，第几页",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          }
        ]
      }
    },
    "/text/coupletai": {
      "post": {
        "summary": "人工智能对联生成",
        "description": "基于百万数据训练\n接口标签：文本处理、NLP、人工智能、AI 训练与应答、多结果返回\n接口特性：\n- AI 基于百万历史对联数据训练应答模型\n- 机器学习持续训练学习\n- 一个上联可返回多个下联应答\n- 毫秒级响应性能\n- 围绕“人工智能对联生成”提供标准化能力，便于快速接入现有业务\n- 适合将“人工智能对联生成”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/coupletai",
        "operationId": "post_coupletai",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/coupletai"
        },
        "x-gugudata-api-identity": "coupletai",
        "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": "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/text/coupletai/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": {
                  "firstpair": {
                    "type": "string",
                    "description": "对联上联文本"
                  }
                },
                "required": [
                  "firstpair"
                ]
              },
              "example": {
                "firstpair": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/detectlanguage": {
      "post": {
        "summary": "NLP 语种检测",
        "description": "180+ 语言检测\n接口标签：文本处理、NLP、人工智能、语种全称与缩写、返回置信度\n接口特性：\n- 基于 NLP 分析文本的语种\n- 支持 180+ 多语种检测\n- 语种缩写遵循 ISO 639-1 标准\n- 包含检测到的语种置信度\n- 毫秒级响应性能\n- 围绕“NLP 语种检测”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 语种检测”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n详情页：https://www.gugudata.com/api/details/nlpdetectlanguage",
        "operationId": "post_nlpdetectlanguage",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/nlpdetectlanguage"
        },
        "x-gugudata-api-identity": "nlpdetectlanguage",
        "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": {
                        "Language": {
                          "type": "string",
                          "description": "检测到的语种"
                        },
                        "LanguageAbbr": {
                          "type": "string",
                          "description": "检测到的语种缩写，语种缩写遵循 ISO 639-1 标准"
                        },
                        "Probability": {
                          "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/text/detectlanguage/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": "待检测文本内容"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/english-words-chinese": {
      "get": {
        "summary": "英文单词中文释义查询",
        "description": "英文单词释义与扩展讲解\n接口标签：文本、英文字典、英文词汇解析、分页模糊检索\n接口特性：\n- 覆盖 8000+ 常见英文词条\n- 支持单词与释义内容双字段模糊检索\n- 按英文单词去重后分页返回，结果更稳定\n- 提供例句、词根词缀、记忆方法等扩展信息\n- 围绕“英文单词中文释义查询”提供标准化能力，便于快速接入现有业务\n- 适合将“英文单词中文释义查询”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/english-words-chinese",
        "operationId": "get_english_words_chinese",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/english-words-chinese"
        },
        "x-gugudata-api-identity": "english-words-chinese",
        "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": {
                        "Word": {
                          "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/text/english-words-chinese/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": "computer"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页条数，取值范围 1~20",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          },
          {
            "name": "pageNumber",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          }
        ]
      }
    },
    "/text/entityrecognition": {
      "post": {
        "summary": "NLP 命名实体识别",
        "description": "专注于识别实体位置和类别\n接口标签：文本处理、NLP、基于 NLP、基于机器学习\n接口特性：\n- 秒级分析标注性能\n- 基于 NLP 算法智能计算\n- 实体类别为 MSRA 规范\n- 底层模型以及语料库持续更新集成中\n- 围绕“NLP 命名实体识别”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 命名实体识别”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/nlpentityrecognition",
        "operationId": "post_nlpentityrecognition",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/nlpentityrecognition"
        },
        "x-gugudata-api-identity": "nlpentityrecognition",
        "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": "string"
                      },
                      "description": "标注实体数组，结构为：[实体内容, 实体类别, 实体开始位置, 实体结束位置]，实体类别为 MSRA 规范。"
                    }
                  },
                  "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/text/entityrecognition/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": "文本内容"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/formatarticle": {
      "post": {
        "summary": "NLP 中英文排版规范化",
        "description": "自动中英文排版、标点符号格式化\n接口标签：文本处理、NLP、中英混排格式化、标点修正\n接口特性：\n- 支持中英文混排格式化\n- 自动在汉字与英文字符、英文标点、数字间添加空格\n- 中文标点符号自动规范化，遵从 [标点符号用法 GB/T 15834 2011]\n- 无意义的全角标点以及英文字符、数字等自动修正\n- 围绕“NLP 中英文排版规范化”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 中英文排版规范化”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/formatarticle",
        "operationId": "post_formatarticle",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/formatarticle"
        },
        "x-gugudata-api-identity": "formatarticle",
        "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": {
                        "SourceContent": {
                          "type": "string",
                          "description": "格式化、规范化前的内容"
                        },
                        "FormatContent": {
                          "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/text/formatarticle/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": "需要格式化、规范化的内容"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/isbn": {
      "get": {
        "summary": "国际标准书号 ISBN",
        "description": "图书 ISBN 资料与出版信息查询\n接口标签：基础数据、图书基础信息、永久图书封面\n接口特性：\n- 最全百万级图书 ISBN 信息查询\n- 返回详细图书基础信息\n- 永久提供图书封面图片存储\n- 数据秒级返回\n- 数据持续更新与维护\n- 围绕“国际标准书号 ISBN”提供标准化能力，便于快速接入现有业务\n- 适合将“国际标准书号 ISBN”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n详情页：https://www.gugudata.com/api/details/isbn",
        "operationId": "get_isbn",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/isbn"
        },
        "x-gugudata-api-identity": "isbn",
        "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": {
                        "Title": {
                          "type": "string",
                          "description": "图书名称"
                        },
                        "CoverImage": {
                          "type": "string",
                          "description": "图书封面图片永久地址"
                        },
                        "ISBN": {
                          "type": "string",
                          "description": "ISBN"
                        },
                        "Author": {
                          "type": "string",
                          "description": "作者"
                        },
                        "Translator": {
                          "type": "string",
                          "description": "译者，没有译者时返回空字符串"
                        },
                        "Publisher": {
                          "type": "string",
                          "description": "出版商"
                        },
                        "PublisherDateTime": {
                          "type": "string",
                          "description": "出版年月，格式 2022-3"
                        },
                        "PageNumber": {
                          "type": "integer",
                          "format": "int32",
                          "description": "图书总页码"
                        },
                        "Binding": {
                          "type": "string",
                          "description": "图书包装类型，如平装、精装"
                        },
                        "BriefIntroduction": {
                          "type": "string",
                          "description": "图书简介"
                        },
                        "AuthorIntroduction": {
                          "type": "string",
                          "description": "作者简介"
                        },
                        "Price": {
                          "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/text/isbn/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "isbn",
            "in": "query",
            "required": false,
            "description": "图书 ISBN；与 keywords 参数至少传递一个，如 9787020002320",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "keywords",
            "in": "query",
            "required": false,
            "description": "图书标题搜索关键字；与 isbn 参数至少传递一个",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "pageindex",
            "in": "query",
            "required": false,
            "description": "搜索结果分页参数，第几页",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pagesize",
            "in": "query",
            "required": false,
            "description": "搜索结果分页参数，每页条数，最大值为 10",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 10
          }
        ]
      }
    },
    "/text/nlpabstract": {
      "post": {
        "summary": "NLP 关键字摘要智能提取",
        "description": "NLP 智能提取\n接口标签：文本处理、NLP、人工智能、基于 NLP、返回关键字与摘要\n接口特性：\n- 毫秒级提取性能\n- 基于 NLP 算法智能提取\n- 可返回摘要、关键字类型数据\n- 摘要、关键字最多 5 个结果值\n- 围绕“NLP 关键字摘要智能提取”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 关键字摘要智能提取”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/nlpabstract",
        "operationId": "post_nlpabstract",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/nlpabstract"
        },
        "x-gugudata-api-identity": "nlpabstract",
        "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": {
                        "ListAbstractKeywords": {
                          "type": "object",
                          "properties": {
                            "Word": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "提取的关键字，最多 5 个"
                            }
                          }
                        },
                        "ListAbstractSummary": {
                          "type": "object",
                          "properties": {
                            "Sentence": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              },
                              "description": "提取的摘要，最多 5 条"
                            }
                          }
                        }
                      },
                      "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/text/nlpabstract/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": "内容正文"
                  }
                },
                "required": [
                  "content"
                ]
              },
              "example": {
                "content": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/segment": {
      "get": {
        "summary": "NLP 中文文本分词",
        "description": "提供精准的中文文本分词接口\n接口标签：文本处理、NLP、支持 HTTPS、高效精准\n接口特性：\n- 提供精准、高效的中文分词接口\n- 自定义的分词分隔符\n- 每月两次次更新分词基础数据库\n- 围绕“NLP 中文文本分词”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 中文文本分词”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n- 支持将文本处理结果接入编辑器、客服系统和知识库\n详情页：https://www.gugudata.com/api/details/segment",
        "operationId": "get_segment",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/segment"
        },
        "x-gugudata-api-identity": "segment",
        "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": {
                        "SegmentaryText": {
                          "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/text/segment/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "text",
            "in": "query",
            "required": true,
            "description": "需要进行分词的文本内容",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "split",
            "in": "query",
            "required": false,
            "description": "分词后的分隔符，默认为英文逗号",
            "schema": {
              "type": "string"
            },
            "example": ","
          }
        ]
      }
    },
    "/text/similarity": {
      "post": {
        "summary": "NLP 文本语义相似度检测",
        "description": "专注于语义相似判断\n接口标签：文本处理、NLP、人工智能、基于 NLP、基于机器学习\n接口特性：\n- 秒级分析性能\n- 基于 NLP 算法智能计算\n- 进行语义上相似度精准检测\n- 底层模型以及语料库持续更新集成中\n- 围绕“NLP 文本语义相似度检测”提供标准化能力，便于快速接入现有业务\n- 适合将“NLP 文本语义相似度检测”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n详情页：https://www.gugudata.com/api/details/nlpsimilarity",
        "operationId": "post_nlpsimilarity",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/nlpsimilarity"
        },
        "x-gugudata-api-identity": "nlpsimilarity",
        "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": "number",
                      "description": "两段文本的相似度，相似度范围为 [0, 1]，越接近 1 表示两段文本越相似"
                    }
                  },
                  "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/text/similarity/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": {
                  "content1": {
                    "type": "string",
                    "description": "文本内容1"
                  },
                  "content2": {
                    "type": "string",
                    "description": "文本内容2"
                  }
                },
                "required": [
                  "content1",
                  "content2"
                ]
              },
              "example": {
                "content1": "YOUR_VALUE",
                "content2": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/text/stconvert": {
      "post": {
        "summary": "简体繁体互转",
        "description": "高精度高性能转换\n接口标签：文本处理、超高的转换性能、支持两种繁体字\n接口特性：\n- 毫秒级转换性能\n- 极速解析与返回\n- 支持两种繁体格式，适用多种转换场景\n- 围绕“简体繁体互转”提供标准化能力，便于快速接入现有业务\n- 适合将“简体繁体互转”结果接入业务系统、后台工具和自动化流程\n- 适合文本清洗、内容分析、搜索增强和自动化处理场景\n- 可与摘要、纠错、分词、实体识别和语义分析接口组合\n- 支持将文本处理结果接入编辑器、客服系统和知识库\n详情页：https://www.gugudata.com/api/details/stconvert",
        "operationId": "post_stconvert",
        "tags": [
          "文本与 NLP 接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/stconvert"
        },
        "x-gugudata-api-identity": "stconvert",
        "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": {
                        "ConvertedContent": {
                          "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/text/stconvert/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": "待转换的内容，包含特殊字符的话，需要进行 UrlEncode 编码"
                  },
                  "from": {
                    "type": "string",
                    "description": "s|t|thk|ttw，原始的内容类型，s: 简体 t: 繁体 thk: 香港繁体 ttw: 台湾繁体"
                  },
                  "to": {
                    "type": "string",
                    "description": "s|t|thk|ttw，转换的目标类型，s: 简体 t: 繁体 thk: 香港繁体 ttw: 台湾繁体"
                  }
                },
                "required": [
                  "content",
                  "from",
                  "to"
                ]
              },
              "example": {
                "content": "YOUR_VALUE",
                "from": "YOUR_VALUE",
                "to": "YOUR_VALUE"
              }
            }
          }
        }
      }
    },
    "/v1/document-extractions": {
      "post": {
        "summary": "AI 文档字段结构化解析",
        "description": "从文档结构化解析出标准 JSON 数据\n接口标签：AI、文档解析、字段抽取、JSON、结构化 JSON\n接口特性：\n- 支持 PDF、DOCX、DOC（Word OpenXML 内容）、TXT、MD/Markdown 及纯文本输入，可覆盖合同、招投标文件、采购公告、报告、制度文件和业务申请材料等常见文档\n- 支持调用方自定义 JSON Schema 子集字段结构，按业务字段 Key 返回标准 JSON，便于系统直接入库、对账和流程编排\n- 支持多层 object、array、string、number、integer、boolean 等字段类型定义，可表达复杂文档的层级化结构化要求\n- 支持 required、title、description、format、items、properties 等常用字段约束，让字段口径、单位、格式和业务语义更清晰\n- 内置文档文本抽取能力，能够从可复制文本的 PDF、Word、Markdown 和纯文本中提取正文、段落、表格行等信息\n- 支持 OCR 触发策略配置，原生文本不足或扫描型 PDF 可按 auto、always、never 策略选择是否进行 OCR 辅助解析\n- AI 抽取结果会经过服务端 Schema 校验、类型检查和归一化处理，降低自由文本输出对下游系统造成的不确定性\n- 每个字段返回状态、原始值、归一化值、字段类型、置信度、失败原因和证据片段，便于自动化处理与人工复核\n- 支持字段级失败原因区分，可识别未找到、类型不匹配、低置信度、结果歧义、Schema 不支持和解析异常等情况\n- 返回整体解析统计，包括字段总数、成功字段数、失败字段数和成功率，便于客户侧监控解析质量和任务效果\n- 支持同步与异步两种执行模式，小文档可同步返回，大文档、扫描件或批量任务可通过 operationId 轮询获取结果\n- 支持 Demo 原始文档地址回传，开发者可以对照原文、字段值、证据片段和解析结果快速完成联调验证\n- 适用于招投标解析、采购公告入库、合同字段抽取、财务报告解析、审计材料整理、资质文件审核等高价值业务场景\n- 统一使用 DataStatus + Data 返回结构，便于与咕咕数据现有接口、Postman 集合、OpenAPI 文档和企业后端系统集成\n- 提供 7*24 小时稳定接口服务\n详情页：https://www.gugudata.com/api/details/document-field-extraction",
        "operationId": "post_document_field_extraction",
        "tags": [
          "AI/模型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/document-field-extraction"
        },
        "x-gugudata-api-identity": "document-field-extraction",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "请求成功",
            "remark": "文档字段解析成功，或异步任务创建成功。"
          },
          {
            "code": "501",
            "title": "参数错误或 schema 不受支持",
            "remark": "常见原因包括缺少 appkey、file 和 text 未二选一、schema 不是合法 JSON、schema 字段类型不受支持、上传文件为空或文件格式不支持。"
          },
          {
            "code": "504",
            "title": "APPKEY 错误或无权限",
            "remark": "AppKey 不存在、已过期、未购买当前接口或没有当前接口调用权限。"
          },
          {
            "code": "-9",
            "title": "处理异常",
            "remark": "服务端解析、OCR、AI 抽取或异步任务处理过程中发生异常，可稍后重试或联系技术支持。"
          }
        ],
        "responses": {
          "200": {
            "description": "接口正常响应。请求成功，业务状态请结合响应体中的自定义业务码判断。",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "DataStatus": {
                      "type": "object",
                      "properties": {
                        "StatusCode": {
                          "type": "integer",
                          "format": "int32",
                          "description": "业务状态码。100 表示请求成功；501 表示参数错误、Schema 不受支持、输入为空或文件类型不支持；504 表示 AppKey 无效或无权限；-9 表示服务端处理异常。接入时建议同时判断 HTTP 状态码和业务状态码。"
                        },
                        "StatusDescription": {
                          "type": "string",
                          "description": "业务状态说明，返回本次请求的处理结果或错误提示，便于日志记录、用户提示和异常排查。"
                        },
                        "ResponseDateTime": {
                          "type": "string",
                          "description": "接口响应时间，由服务端生成，可用于调用链路日志、对账和问题定位。"
                        },
                        "DataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "本次返回的数据条数。同步解析成功时通常为 1；异步任务创建成功时表示任务返回对象数量。"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "requestId": {
                          "type": "string",
                          "description": "本次文档解析请求 ID。同步结果和异步任务结果都会返回，可用于客户侧日志追踪、排查单次解析结果和与技术支持沟通。"
                        },
                        "mode": {
                          "type": "string",
                          "description": "执行模式结果。sync 表示已同步完成并返回字段结果；async 表示已创建异步任务或返回异步任务结果。"
                        },
                        "document": {
                          "type": "object",
                          "properties": {
                            "fileName": {
                              "type": "string",
                              "description": "文档文件名。file 上传时来自上传文件名；text 输入时可为空，用于区分不同来源的解析结果。"
                            },
                            "contentType": {
                              "type": "string",
                              "description": "上传文件的 Content-Type，例如 application/pdf、application/vnd.openxmlformats-officedocument.wordprocessingml.document、text/plain 等。"
                            },
                            "extension": {
                              "type": "string",
                              "description": "服务端识别到的文档扩展名或解析类型，例如 .pdf、.docx、.txt、.md、text 等。"
                            },
                            "pageCount": {
                              "type": "integer",
                              "format": "int32",
                              "description": "文档页数或解析页数估计值。PDF 通常返回实际页数，Word、TXT、Markdown 和纯文本通常按解析结果返回。"
                            },
                            "charCount": {
                              "type": "integer",
                              "format": "int32",
                              "description": "服务端抽取到并参与 AI 解析的文本字符数，可用于判断文档是否为空、是否需要 OCR 或是否超出同步处理范围。"
                            },
                            "textExtraction": {
                              "type": "object",
                              "properties": {
                                "method": {
                                  "type": "string",
                                  "description": "文本来源方式。native 表示原生文本抽取，ocr 表示 OCR 识别，text 表示调用方直接传入纯文本。"
                                },
                                "sectionCount": {
                                  "type": "integer",
                                  "format": "int32",
                                  "description": "文本分段数量，通常对应段落、表格行、页面片段或 OCR 分段，可辅助判断解析覆盖范围。"
                                }
                              }
                            }
                          }
                        },
                        "summary": {
                          "type": "object",
                          "properties": {
                            "totalFields": {
                              "type": "integer",
                              "format": "int32",
                              "description": "schema 中需要解析的字段总数，包含嵌套对象和数组中的叶子字段。"
                            },
                            "succeededFields": {
                              "type": "integer",
                              "format": "int32",
                              "description": "成功解析并通过类型校验、归一化处理的字段数量。"
                            },
                            "failedFields": {
                              "type": "integer",
                              "format": "int32",
                              "description": "未能成功解析的字段数量，包括未找到、类型不匹配、低置信度、结果歧义、Schema 不支持或解析异常。"
                            },
                            "successRate": {
                              "type": "number",
                              "description": "字段解析成功率，取值 0 到 1，计算方式为 succeededFields / totalFields，可用于质量监控和自动化阈值判断。"
                            }
                          }
                        },
                        "values": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "字段解析结果对象。key 与 schema.properties 中的字段 key 保持一致，value 为字段级解析结果。",
                          "properties": {
                            "{field}": {
                              "type": "object",
                              "properties": {
                                "status": {
                                  "type": "string",
                                  "description": "字段级状态。可能值包括 SUCCEEDED、NOT_FOUND、TYPE_MISMATCH、LOW_CONFIDENCE、AMBIGUOUS、UNSUPPORTED_SCHEMA、EXTRACTION_ERROR。"
                                },
                                "value": {
                                  "type": "string",
                                  "description": "从文档中抽取到的原始字段值，尽量保留文档原始表达，例如 70万元、2026年7月29日09点30分、企业全称等。"
                                },
                                "normalizedValue": {
                                  "type": "string",
                                  "description": "按 schema 类型和字段语义归一化后的值，例如金额数字、标准日期时间、布尔值、整数、数组或对象；当字段未找到或类型不匹配时可能为 null。"
                                },
                                "type": {
                                  "type": "string",
                                  "description": "该字段在 schema 中声明的类型，用于客户侧做二次校验、映射和入库。"
                                },
                                "confidence": {
                                  "type": "number",
                                  "description": "字段级置信度，取值 0 到 1。数值越高表示模型越确定；低于阈值时建议进入人工复核或重试流程。"
                                },
                                "reason": {
                                  "type": "string",
                                  "description": "字段失败、低置信度或存在歧义时的原因说明；成功字段通常为空。"
                                },
                                "evidence": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "source": {
                                        "type": "string",
                                        "description": "证据片段来源位置，例如 page:1、paragraph:3、table:2:row:5 或 section:1，便于回看原文。"
                                      },
                                      "text": {
                                        "type": "string",
                                        "description": "支持该字段值的简短原文证据片段，便于人工核对和审计留痕。"
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        },
                        "failedFields": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "path": {
                                "type": "string",
                                "description": "解析失败字段路径。嵌套字段会使用点路径表示，例如 supplier.name 或 items.amount。"
                              },
                              "status": {
                                "type": "string",
                                "description": "失败字段状态，取值同字段级 status，用于客户侧按失败类型分流处理。"
                              },
                              "reason": {
                                "type": "string",
                                "description": "失败字段原因，例如文档中未找到、提取值与类型不匹配、置信度过低或结果存在歧义。"
                              }
                            }
                          }
                        },
                        "warnings": {
                          "type": "array",
                          "items": {
                            "type": "string",
                            "description": "非致命警告信息。例如 OCR 服务不可用但已使用原生文本解析、OCR 未识别出更多文本等。"
                          }
                        },
                        "sourceDocumentUrl": {
                          "type": "string",
                          "description": "Demo 接口返回的原始示例文档地址，方便开发者对照原文件、证据片段和解析结果；正式接口通常不返回该字段。"
                        },
                        "operationId": {
                          "type": "string",
                          "description": "异步模式下返回的任务 ID。调用方可使用 pollingUrl 或现有 operation 查询接口轮询任务状态。"
                        },
                        "status": {
                          "type": "string",
                          "description": "异步任务状态，例如 PENDING、RUNNING、SUCCEEDED、FAILED、EXPIRED。同步模式下通常不返回该字段。"
                        },
                        "pollingUrl": {
                          "type": "string",
                          "description": "异步任务轮询地址，例如 /ai/operations/{operationId}。任务成功后返回同一套文档解析结果结构。"
                        },
                        "expiresAt": {
                          "type": "string",
                          "description": "异步任务过期时间，超过该时间后任务记录可能被清理，建议客户侧及时轮询和持久化结果。"
                        }
                      },
                      "description": "字段解析结果对象。key 与 schema.properties 中的字段 key 保持一致，value 为字段级解析结果。"
                    }
                  },
                  "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/v1/document-extractions/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": "待解析的文档文件。接口使用 multipart/form-data 上传，file 和 text 必须二选一且不能同时传；支持 PDF、DOCX、DOC（Word OpenXML 内容）、TXT、MD/Markdown。建议优先上传可复制文本的 PDF 或 .docx；扫描版 PDF 可配合 ocrMode=auto/always；空文件、无法识别内容或不支持的传统二进制文档会返回参数错误或文件类型不支持。Demo 原始文件：https://static.gugudata.com/api-demo/document-field-extraction/report-ai-tool-procurement.doc。"
                  },
                  "text": {
                    "type": "string",
                    "description": "待解析的纯文本内容。适用于调用方已完成网页抽取、OCR、文档转换或内部系统取数后的场景；file 和 text 必须二选一且不能同时传。文本建议保留标题、段落、表格行列关系、编号、金额单位和日期上下文，以提升字段定位、类型归一化和证据片段质量。"
                  },
                  "schema": {
                    "type": "string",
                    "description": "字段定义 JSON 字符串，采用 JSON Schema 子集。顶层必须是 type=object，properties 中每个 key 是返回结果里的字段 key；支持 string、number、integer、boolean、object、array，以及 required、title、description、format、items、properties 等常用约束。建议使用稳定英文 key，中文展示名放 title，单位、枚举范围、抽取口径和优先章节写入 description。示例：{\"type\":\"object\",\"required\":[\"projectName\"],\"properties\":{\"projectName\":{\"type\":\"string\",\"title\":\"项目名称\",\"description\":\"采购或招标项目名称\"}}}。"
                  },
                  "instruction": {
                    "type": "string",
                    "description": "可选的补充解析说明。用于描述文档背景、金额单位、日期时区、币种、大小写规则、冲突字段优先级、是否优先某个章节等业务口径；字段结构仍以 schema 为准，不建议在 instruction 中重复整份 schema。"
                  },
                  "ocrMode": {
                    "type": "string",
                    "description": "OCR 触发模式，可选 auto、always、never。auto 表示系统根据原生文本密度、页数和扫描特征自动判断是否需要 OCR；always 表示即使存在原生文本也尝试 OCR；never 表示只使用原生文本。通常建议使用 auto，扫描件或图片型 PDF 可使用 always，已确认可复制文本的文档可使用 never 降低处理时间。"
                  },
                  "executionMode": {
                    "type": "string",
                    "description": "执行模式，可选 auto、sync、async。auto 表示系统根据文档大小、字符数、页数和处理耗时预估自动选择同步或异步；sync 适合小文档和低延迟调用；async 会创建异步任务并返回 operationId，适合大文档、扫描件、批量文件和后台稳定处理。"
                  }
                },
                "required": [
                  "schema"
                ]
              },
              "example": {
                "file": "无",
                "text": "无",
                "schema": "无",
                "instruction": "无",
                "ocrMode": "auto",
                "executionMode": "auto"
              }
            }
          }
        }
      }
    },
    "/v1/psychology/questionnaires": {
      "get": {
        "summary": "职业与发展心理测评问卷",
        "description": "职业发展心理测评题库\n接口标签：心理测评、原创题库、职业发展、高考心理\n接口特性：\n- 支持检索职业与发展心理测评问卷元数据\n- 返回问卷编码、名称、题量、维度和来源，便于后续发起测评或展示问卷库\n- keyword 可按名称、英文名或描述进行筛选\n- 适合职业规划、人才测评、教育咨询和成长发展类产品接入\n- 围绕“职业与发展心理测评问卷”提供标准化能力，便于快速接入现有业务\n- 适合将“职业与发展心理测评问卷”结果接入业务系统、后台工具和自动化流程\n- 适合高考、考研、招生和院校信息产品接入\n- 可与院校、专业、分数线和招生计划接口组合分析\n详情页：https://www.gugudata.com/api/details/psychology-questionnaires",
        "operationId": "get_psychology_questionnaires",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/psychology-questionnaires"
        },
        "x-gugudata-api-identity": "psychology-questionnaires",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号）"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "网关/CDN 可能返回 429 或业务状态码 502"
          },
          {
            "code": "503",
            "title": "账号欠费或订单过期",
            "remark": "请前往开发者中心检查订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "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": "接口返回状态码。"
                        },
                        "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": {
                        "QuestionnaireCode": {
                          "type": "string",
                          "description": "问卷编码。"
                        },
                        "QuestionnaireName": {
                          "type": "string",
                          "description": "问卷中文名称。"
                        },
                        "QuestionnaireNameEn": {
                          "type": "string",
                          "description": "问卷英文名称。"
                        },
                        "Description": {
                          "type": "string",
                          "description": "问卷简介。"
                        },
                        "QuestionCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "题目数量。"
                        },
                        "Dimensions": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "测评维度列表。"
                        },
                        "Source": {
                          "type": "string",
                          "description": "问卷来源或参考体系。"
                        },
                        "UseCount": {
                          "type": "integer",
                          "format": "int32",
                          "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/v1/psychology/questionnaires/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "问卷名称、英文名或描述关键词。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": false,
            "description": "分页页码，从 1 开始。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          }
        ]
      }
    },
    "/v1/psychology/questionnaires/{questionnaireCode}": {
      "get": {
        "summary": "获取问卷详情",
        "description": "获取指定问卷的详细信息和所有题目\n接口标签：心理测评、原创题库、职业发展、高考心理\n详情页：https://www.gugudata.com/api/details/psychology-questionnaires",
        "operationId": "get_get_v1_psychology_questionnaires_questionnairecode",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/psychology-questionnaires"
        },
        "x-gugudata-api-identity": "psychology-questionnaires",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号）"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "网关/CDN 可能返回 429 或业务状态码 502"
          },
          {
            "code": "503",
            "title": "账号欠费或订单过期",
            "remark": "请前往开发者中心检查订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "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": {
                        "QuestionnaireCode": {
                          "type": "string"
                        },
                        "QuestionnaireName": {
                          "type": "string"
                        },
                        "QuestionnaireNameEn": {
                          "type": "string"
                        },
                        "Description": {
                          "type": "string"
                        },
                        "QuestionCount": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "Dimensions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "DimensionCode": {
                                "type": "string"
                              },
                              "DimensionName": {
                                "type": "string"
                              },
                              "Description": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "Instructions": {
                          "type": "string"
                        },
                        "Source": {
                          "type": "string"
                        },
                        "Questions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "QuestionNumber": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "QuestionText": {
                                "type": "string"
                              },
                              "QuestionType": {
                                "type": "string"
                              },
                              "Options": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "OptionKey": {
                                      "type": "string"
                                    },
                                    "OptionText": {
                                      "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": "psychology-questionnaires",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/psychology-questionnaires",
        "parameters": [
          {
            "name": "questionnaireCode",
            "in": "path",
            "required": true,
            "description": "问卷编码（路径参数）。可选值：HOLLAND_SDS（霍兰德职业兴趣测验）、TYPE_A_BEHAVIOR（A型行为量表）、ACHIEVEMENT_MOTIVATION（成就动机量表）、ONET_IP_30（O*NET 职业兴趣画像（30题））、CAAS_SF_24（生涯适应力量表短版（24题））、CDSE_SF_25（职业决策自我效能短量表（25题））、CDDQ_34（职业决策困难问卷（34题））、LBDQ_40（领导行为描述问卷（40题））、MBI_ES_22（职业倦怠量表（22题））、GD_CAREER_INTEREST_24（职业兴趣画像问卷（24题））、GD_CAREER_ADAPT_20（职业适应力问卷（20题））、GD_DECISION_CONFIDENCE_20（职业决策信心问卷（20题））、GD_DECISION_BARRIER_24（职业决策障碍问卷（24题））、GD_LEADERSHIP_STYLE_24（团队领导行为问卷（24题））、GD_WORK_ENGAGEMENT_18（工作投入度问卷（18题））、GD_JOB_STRESS_20（岗位压力体验问卷（20题））、GD_JOB_BURNOUT_18（职业倦怠风险问卷（18题））、GD_CAREER_VALUES_24（职业价值观问卷（24题））、GD_JOB_SEARCH_EFFICACY_16（求职执行效能问卷（16题））、GD_TEAM_COLLAB_18（团队协作质量问卷（18题））、GD_CAREER_COMMITMENT_16（职业承诺问卷（16题））、GD_GRAD_TRANSITION_STRESS_20（毕业过渡压力问卷（20题））、GD_GRAD_EMPLOYABILITY_20（毕业就业能力问卷（20题））、GD_ACADEMIC_BURNOUT_18（学习倦怠风险问卷（18题））、GD_LEARNING_MOTIVATION_20（学习动机问卷（20题））、GD_SELF_ESTEEM_12（自我评价问卷（12题））、GD_RESILIENCE_12（心理韧性问卷（12题））、GD_SOCIAL_SUPPORT_12（社会支持感知问卷（12题））、GD_PERCEIVED_STRESS_12（主观压力体验问卷（12题））、GD_EXAM_ANXIETY_20（考试焦虑体验问卷（20题））、GD_STATE_TENSION_12（即时紧张状态问卷（12题））、GD_ACHIEVEMENT_GOAL_15（学业目标取向问卷（15题））、GD_STUDY_EFFICACY_15（学习效能问卷（15题））、GD_MOOD_RISK_SCREEN_12（情绪风险筛查问卷（12题））",
            "schema": {
              "type": "string",
              "enum": [
                "HOLLAND_SDS",
                "TYPE_A_BEHAVIOR",
                "ACHIEVEMENT_MOTIVATION",
                "ONET_IP_30",
                "CAAS_SF_24",
                "CDSE_SF_25",
                "CDDQ_34",
                "LBDQ_40",
                "MBI_ES_22",
                "GD_CAREER_INTEREST_24",
                "GD_CAREER_ADAPT_20",
                "GD_DECISION_CONFIDENCE_20",
                "GD_DECISION_BARRIER_24",
                "GD_LEADERSHIP_STYLE_24",
                "GD_WORK_ENGAGEMENT_18",
                "GD_JOB_STRESS_20",
                "GD_JOB_BURNOUT_18",
                "GD_CAREER_VALUES_24",
                "GD_JOB_SEARCH_EFFICACY_16",
                "GD_TEAM_COLLAB_18",
                "GD_CAREER_COMMITMENT_16",
                "GD_GRAD_TRANSITION_STRESS_20",
                "GD_GRAD_EMPLOYABILITY_20",
                "GD_ACADEMIC_BURNOUT_18",
                "GD_LEARNING_MOTIVATION_20",
                "GD_SELF_ESTEEM_12",
                "GD_RESILIENCE_12",
                "GD_SOCIAL_SUPPORT_12",
                "GD_PERCEIVED_STRESS_12",
                "GD_EXAM_ANXIETY_20",
                "GD_STATE_TENSION_12",
                "GD_ACHIEVEMENT_GOAL_15",
                "GD_STUDY_EFFICACY_15",
                "GD_MOOD_RISK_SCREEN_12"
              ]
            }
          },
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/v1/psychology/tests": {
      "post": {
        "summary": "提交测试答案",
        "description": "提交用户答案，自动计算得分并生成测评结果\n接口标签：心理测评、原创题库、职业发展、高考心理\n详情页：https://www.gugudata.com/api/details/psychology-questionnaires",
        "operationId": "post_post_v1_psychology_tests",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/psychology-questionnaires"
        },
        "x-gugudata-api-identity": "psychology-questionnaires",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号）"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "网关/CDN 可能返回 429 或业务状态码 502"
          },
          {
            "code": "503",
            "title": "账号欠费或订单过期",
            "remark": "请前往开发者中心检查订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "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": {
                        "TestId": {
                          "type": "string"
                        },
                        "QuestionnaireCode": {
                          "type": "string"
                        },
                        "QuestionnaireName": {
                          "type": "string"
                        },
                        "TotalScore": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "DimensionScores": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "DimensionCode": {
                                "type": "string"
                              },
                              "DimensionName": {
                                "type": "string"
                              },
                              "Score": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "MaxScore": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "ScoreRate": {
                                "type": "number"
                              },
                              "Interpretation": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "ResultType": {
                          "type": "string"
                        },
                        "Interpretation": {
                          "type": "string"
                        },
                        "Suggestion": {
                          "type": "string"
                        },
                        "TestDateTime": {
                          "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": "psychology-questionnaires",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/psychology-questionnaires",
        "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": {
                  "questionnaireCode": {
                    "type": "string",
                    "description": "问卷编码（请求体）。可选值：HOLLAND_SDS（霍兰德职业兴趣测验）、TYPE_A_BEHAVIOR（A型行为量表）、ACHIEVEMENT_MOTIVATION（成就动机量表）、ONET_IP_30（O*NET 职业兴趣画像（30题））、CAAS_SF_24（生涯适应力量表短版（24题））、CDSE_SF_25（职业决策自我效能短量表（25题））、CDDQ_34（职业决策困难问卷（34题））、LBDQ_40（领导行为描述问卷（40题））、MBI_ES_22（职业倦怠量表（22题））、GD_CAREER_INTEREST_24（职业兴趣画像问卷（24题））、GD_CAREER_ADAPT_20（职业适应力问卷（20题））、GD_DECISION_CONFIDENCE_20（职业决策信心问卷（20题））、GD_DECISION_BARRIER_24（职业决策障碍问卷（24题））、GD_LEADERSHIP_STYLE_24（团队领导行为问卷（24题））、GD_WORK_ENGAGEMENT_18（工作投入度问卷（18题））、GD_JOB_STRESS_20（岗位压力体验问卷（20题））、GD_JOB_BURNOUT_18（职业倦怠风险问卷（18题））、GD_CAREER_VALUES_24（职业价值观问卷（24题））、GD_JOB_SEARCH_EFFICACY_16（求职执行效能问卷（16题））、GD_TEAM_COLLAB_18（团队协作质量问卷（18题））、GD_CAREER_COMMITMENT_16（职业承诺问卷（16题））、GD_GRAD_TRANSITION_STRESS_20（毕业过渡压力问卷（20题））、GD_GRAD_EMPLOYABILITY_20（毕业就业能力问卷（20题））、GD_ACADEMIC_BURNOUT_18（学习倦怠风险问卷（18题））、GD_LEARNING_MOTIVATION_20（学习动机问卷（20题））、GD_SELF_ESTEEM_12（自我评价问卷（12题））、GD_RESILIENCE_12（心理韧性问卷（12题））、GD_SOCIAL_SUPPORT_12（社会支持感知问卷（12题））、GD_PERCEIVED_STRESS_12（主观压力体验问卷（12题））、GD_EXAM_ANXIETY_20（考试焦虑体验问卷（20题））、GD_STATE_TENSION_12（即时紧张状态问卷（12题））、GD_ACHIEVEMENT_GOAL_15（学业目标取向问卷（15题））、GD_STUDY_EFFICACY_15（学习效能问卷（15题））、GD_MOOD_RISK_SCREEN_12（情绪风险筛查问卷（12题））",
                    "enum": [
                      "HOLLAND_SDS",
                      "TYPE_A_BEHAVIOR",
                      "ACHIEVEMENT_MOTIVATION",
                      "ONET_IP_30",
                      "CAAS_SF_24",
                      "CDSE_SF_25",
                      "CDDQ_34",
                      "LBDQ_40",
                      "MBI_ES_22",
                      "GD_CAREER_INTEREST_24",
                      "GD_CAREER_ADAPT_20",
                      "GD_DECISION_CONFIDENCE_20",
                      "GD_DECISION_BARRIER_24",
                      "GD_LEADERSHIP_STYLE_24",
                      "GD_WORK_ENGAGEMENT_18",
                      "GD_JOB_STRESS_20",
                      "GD_JOB_BURNOUT_18",
                      "GD_CAREER_VALUES_24",
                      "GD_JOB_SEARCH_EFFICACY_16",
                      "GD_TEAM_COLLAB_18",
                      "GD_CAREER_COMMITMENT_16",
                      "GD_GRAD_TRANSITION_STRESS_20",
                      "GD_GRAD_EMPLOYABILITY_20",
                      "GD_ACADEMIC_BURNOUT_18",
                      "GD_LEARNING_MOTIVATION_20",
                      "GD_SELF_ESTEEM_12",
                      "GD_RESILIENCE_12",
                      "GD_SOCIAL_SUPPORT_12",
                      "GD_PERCEIVED_STRESS_12",
                      "GD_EXAM_ANXIETY_20",
                      "GD_STATE_TENSION_12",
                      "GD_ACHIEVEMENT_GOAL_15",
                      "GD_STUDY_EFFICACY_15",
                      "GD_MOOD_RISK_SCREEN_12"
                    ]
                  },
                  "userId": {
                    "type": "string",
                    "description": "用户标识（请求体，可选）"
                  },
                  "timeSpent": {
                    "type": "integer",
                    "format": "int32",
                    "description": "答题耗时秒数（请求体，可选）"
                  },
                  "answers": {
                    "type": "object",
                    "additionalProperties": true,
                    "description": "答案对象（请求体），必须包含该问卷全部题号"
                  }
                },
                "required": [
                  "questionnaireCode",
                  "answers"
                ]
              },
              "example": {
                "questionnaireCode": "",
                "userId": "",
                "timeSpent": 0,
                "answers": {}
              }
            }
          }
        }
      },
      "get": {
        "summary": "用户测试历史",
        "description": "查询用户的历史测试记录列表，支持按问卷类型过滤\n接口标签：心理测评、原创题库、职业发展、高考心理\n详情页：https://www.gugudata.com/api/details/psychology-questionnaires",
        "operationId": "get_get_v1_psychology_tests",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/psychology-questionnaires"
        },
        "x-gugudata-api-identity": "psychology-questionnaires",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号）"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "网关/CDN 可能返回 429 或业务状态码 502"
          },
          {
            "code": "503",
            "title": "账号欠费或订单过期",
            "remark": "请前往开发者中心检查订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "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": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "TestId": {
                            "type": "string"
                          },
                          "QuestionnaireCode": {
                            "type": "string"
                          },
                          "QuestionnaireName": {
                            "type": "string"
                          },
                          "TotalScore": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "ResultType": {
                            "type": "string"
                          },
                          "TestDateTime": {
                            "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": "psychology-questionnaires",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/psychology-questionnaires",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "filter",
            "in": "query",
            "required": true,
            "description": "过滤条件，格式：userId=\"xxx\" 或 userId=\"xxx\" AND questionnaireCode=\"yyy\"。questionnaireCode 可选值：HOLLAND_SDS（霍兰德职业兴趣测验）、TYPE_A_BEHAVIOR（A型行为量表）、ACHIEVEMENT_MOTIVATION（成就动机量表）、ONET_IP_30（O*NET 职业兴趣画像（30题））、CAAS_SF_24（生涯适应力量表短版（24题））、CDSE_SF_25（职业决策自我效能短量表（25题））、CDDQ_34（职业决策困难问卷（34题））、LBDQ_40（领导行为描述问卷（40题））、MBI_ES_22（职业倦怠量表（22题））、GD_CAREER_INTEREST_24（职业兴趣画像问卷（24题））、GD_CAREER_ADAPT_20（职业适应力问卷（20题））、GD_DECISION_CONFIDENCE_20（职业决策信心问卷（20题））、GD_DECISION_BARRIER_24（职业决策障碍问卷（24题））、GD_LEADERSHIP_STYLE_24（团队领导行为问卷（24题））、GD_WORK_ENGAGEMENT_18（工作投入度问卷（18题））、GD_JOB_STRESS_20（岗位压力体验问卷（20题））、GD_JOB_BURNOUT_18（职业倦怠风险问卷（18题））、GD_CAREER_VALUES_24（职业价值观问卷（24题））、GD_JOB_SEARCH_EFFICACY_16（求职执行效能问卷（16题））、GD_TEAM_COLLAB_18（团队协作质量问卷（18题））、GD_CAREER_COMMITMENT_16（职业承诺问卷（16题））、GD_GRAD_TRANSITION_STRESS_20（毕业过渡压力问卷（20题））、GD_GRAD_EMPLOYABILITY_20（毕业就业能力问卷（20题））、GD_ACADEMIC_BURNOUT_18（学习倦怠风险问卷（18题））、GD_LEARNING_MOTIVATION_20（学习动机问卷（20题））、GD_SELF_ESTEEM_12（自我评价问卷（12题））、GD_RESILIENCE_12（心理韧性问卷（12题））、GD_SOCIAL_SUPPORT_12（社会支持感知问卷（12题））、GD_PERCEIVED_STRESS_12（主观压力体验问卷（12题））、GD_EXAM_ANXIETY_20（考试焦虑体验问卷（20题））、GD_STATE_TENSION_12（即时紧张状态问卷（12题））、GD_ACHIEVEMENT_GOAL_15（学业目标取向问卷（15题））、GD_STUDY_EFFICACY_15（学习效能问卷（15题））、GD_MOOD_RISK_SCREEN_12（情绪风险筛查问卷（12题））",
            "schema": {
              "type": "string",
              "enum": [
                "HOLLAND_SDS",
                "TYPE_A_BEHAVIOR",
                "ACHIEVEMENT_MOTIVATION",
                "ONET_IP_30",
                "CAAS_SF_24",
                "CDSE_SF_25",
                "CDDQ_34",
                "LBDQ_40",
                "MBI_ES_22",
                "GD_CAREER_INTEREST_24",
                "GD_CAREER_ADAPT_20",
                "GD_DECISION_CONFIDENCE_20",
                "GD_DECISION_BARRIER_24",
                "GD_LEADERSHIP_STYLE_24",
                "GD_WORK_ENGAGEMENT_18",
                "GD_JOB_STRESS_20",
                "GD_JOB_BURNOUT_18",
                "GD_CAREER_VALUES_24",
                "GD_JOB_SEARCH_EFFICACY_16",
                "GD_TEAM_COLLAB_18",
                "GD_CAREER_COMMITMENT_16",
                "GD_GRAD_TRANSITION_STRESS_20",
                "GD_GRAD_EMPLOYABILITY_20",
                "GD_ACADEMIC_BURNOUT_18",
                "GD_LEARNING_MOTIVATION_20",
                "GD_SELF_ESTEEM_12",
                "GD_RESILIENCE_12",
                "GD_SOCIAL_SUPPORT_12",
                "GD_PERCEIVED_STRESS_12",
                "GD_EXAM_ANXIETY_20",
                "GD_STATE_TENSION_12",
                "GD_ACHIEVEMENT_GOAL_15",
                "GD_STUDY_EFFICACY_15",
                "GD_MOOD_RISK_SCREEN_12"
              ]
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页数量，默认 20，最大 100",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "pageToken",
            "in": "query",
            "required": false,
            "description": "页码，默认 1",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          }
        ]
      }
    },
    "/v1/psychology/tests/{testId}": {
      "get": {
        "summary": "查询测试结果",
        "description": "根据测试ID查询测试结果详情\n接口标签：心理测评、原创题库、职业发展、高考心理\n详情页：https://www.gugudata.com/api/details/psychology-questionnaires",
        "operationId": "get_get_v1_psychology_tests_testid",
        "tags": [
          "元数据与教育接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/psychology-questionnaires"
        },
        "x-gugudata-api-identity": "psychology-questionnaires",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "检查必填参数、问卷编码、答案格式（answers 必须为对象且包含全部题号）"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "网关/CDN 可能返回 429 或业务状态码 502"
          },
          {
            "code": "503",
            "title": "账号欠费或订单过期",
            "remark": "请前往开发者中心检查订单有效期"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "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": {
                        "TestId": {
                          "type": "string"
                        },
                        "QuestionnaireCode": {
                          "type": "string"
                        },
                        "QuestionnaireName": {
                          "type": "string"
                        },
                        "Answers": {
                          "type": "object",
                          "properties": {
                            "1": {
                              "type": "string"
                            },
                            "2": {
                              "type": "string"
                            }
                          }
                        },
                        "TotalScore": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "DimensionScores": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "DimensionCode": {
                                "type": "string"
                              },
                              "DimensionName": {
                                "type": "string"
                              },
                              "Score": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "MaxScore": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "ScoreRate": {
                                "type": "number"
                              },
                              "Interpretation": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "ResultType": {
                          "type": "string"
                        },
                        "Interpretation": {
                          "type": "string"
                        },
                        "Suggestion": {
                          "type": "string"
                        },
                        "TestDateTime": {
                          "type": "string"
                        },
                        "TimeSpent": {
                          "type": "integer",
                          "format": "int32"
                        }
                      },
                      "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": "psychology-questionnaires",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/psychology-questionnaires",
        "parameters": [
          {
            "name": "testId",
            "in": "path",
            "required": true,
            "description": "测试记录ID（路径参数）",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/v1/searchVisibilityReports": {
      "post": {
        "summary": "创建搜索可见性报告",
        "description": "创建搜索可见性报告，并自动创建首个观测任务。该接口会按关键词、搜索来源和排名深度消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "create_search_visibility_report",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "name": {
                      "type": "string"
                    },
                    "reportId": {
                      "type": "string"
                    },
                    "displayName": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "string"
                    },
                    "domain": {
                      "type": "string"
                    },
                    "aliases": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "competitors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "domain": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "aliases": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "queries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "locale": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "maxRank": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "latestRunId": {
                      "type": "string"
                    },
                    "latestRunStatus": {
                      "type": "string"
                    },
                    "latestMetrics": {
                      "type": "object",
                      "properties": {}
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "brand": {
                    "type": "string",
                    "description": "品牌或产品名称，长度 1-120。"
                  },
                  "domain": {
                    "type": "string",
                    "description": "需要观测的主域名，可传 gugudata.com 或完整 URL。"
                  },
                  "queries": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "需要观测的搜索关键词列表，1-50 个。创建报告会自动创建首个观测任务，按关键词数量计入 credits 计算。"
                  },
                  "sources": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "搜索来源，支持 google_web、bing_web、baidu_web。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 同等排名深度消耗 10/20/50 credits。"
                  },
                  "displayName": {
                    "type": "string",
                    "description": "报告显示名称。"
                  },
                  "aliases": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "品牌别名列表，最多 20 个。"
                  },
                  "competitors": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "additionalProperties": true
                    },
                    "description": "竞品域名定义列表，最多 10 个；每项支持 domain、name、aliases。"
                  },
                  "locale": {
                    "type": "string",
                    "description": "语言区域提示，如 zh-CN、en-US。"
                  },
                  "region": {
                    "type": "string",
                    "description": "地域提示，如 CN、US、HK。"
                  },
                  "maxRank": {
                    "type": "integer",
                    "format": "int32",
                    "description": "观测排名深度，仅支持 10、20、50，默认 20。Google/Bing 分别消耗 1/2/5 credits，Baidu 分别消耗 10/20/50 credits。"
                  },
                  "includeRawResponse": {
                    "type": "boolean",
                    "description": "是否在问题排查场景保留扩展返回引用。普通业务接入建议保持 false。"
                  }
                },
                "required": [
                  "brand",
                  "domain",
                  "queries",
                  "sources"
                ]
              },
              "example": {
                "brand": "",
                "domain": "",
                "queries": [],
                "sources": [],
                "displayName": "",
                "aliases": [],
                "competitors": [],
                "locale": "",
                "region": "",
                "maxRank": 20,
                "includeRawResponse": false
              }
            }
          }
        }
      },
      "get": {
        "summary": "搜索可见性报告列表",
        "description": "分页读取当前 AppKey 下的搜索可见性报告。支持按 brand/domain 过滤，按 createdAt、updatedAt、domain 排序；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "list_search_visibility_reports",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "reports": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "reportId": {
                            "type": "string"
                          },
                          "displayName": {
                            "type": "string"
                          },
                          "brand": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          },
                          "aliases": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "competitors": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "domain": {
                                  "type": "string"
                                },
                                "name": {
                                  "type": "string"
                                },
                                "aliases": {
                                  "type": "array",
                                  "items": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          },
                          "queries": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "sources": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          },
                          "locale": {
                            "type": "string"
                          },
                          "region": {
                            "type": "string"
                          },
                          "maxRank": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "latestRunId": {
                            "type": "string"
                          },
                          "latestRunStatus": {
                            "type": "string"
                          },
                          "latestMetrics": {
                            "type": "object",
                            "properties": {}
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "nextPageToken": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          },
          {
            "name": "pageToken",
            "in": "query",
            "required": false,
            "description": "分页令牌。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "过滤表达式。报告列表支持 brand/domain；任务列表支持 state；结果列表支持 source/query。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "description": "排序表达式，如 createdAt desc、updatedAt desc、checkedAt desc。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/searchVisibilityReports/{reportId}": {
      "get": {
        "summary": "获取搜索可见性报告",
        "description": "读取指定搜索可见性报告，返回报告配置、最近一次观测任务和最近聚合指标；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "get_search_visibility_report",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "name": {
                      "type": "string"
                    },
                    "reportId": {
                      "type": "string"
                    },
                    "displayName": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "string"
                    },
                    "domain": {
                      "type": "string"
                    },
                    "aliases": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "competitors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "domain": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "aliases": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            }
                          }
                        }
                      }
                    },
                    "queries": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "locale": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "maxRank": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "latestRunId": {
                      "type": "string"
                    },
                    "latestRunStatus": {
                      "type": "string"
                    },
                    "latestMetrics": {
                      "type": "object",
                      "properties": {}
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "reportId",
            "in": "path",
            "required": true,
            "description": "报告 ID。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/searchVisibilityReports/{reportId}/runs": {
      "post": {
        "summary": "创建搜索可见性观测任务",
        "description": "为报告创建一次新的采样观测任务。该接口会按关键词、搜索来源和排名深度消耗 credits；forceRefresh=true 重新观测时同样消耗 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "create_search_visibility_run",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "name": {
                      "type": "string"
                    },
                    "runId": {
                      "type": "string"
                    },
                    "reportId": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string"
                    },
                    "forceRefresh": {
                      "type": "boolean"
                    },
                    "creditCost": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksTotal": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksSucceeded": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksFailed": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "metrics": {
                      "type": "object",
                      "properties": {
                        "queryCoverageRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "top10PresenceRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "top20PresenceRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "bestRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "averageVisibleRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "averageRankWithPenalty": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "competitorGap": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "sourceCoverage": {
                          "type": "object",
                          "properties": {
                            "google_web": {
                              "type": "integer",
                              "format": "int32"
                            }
                          }
                        },
                        "visibilityScore": {
                          "type": "integer",
                          "format": "int32"
                        }
                      }
                    },
                    "errorSummary": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    },
                    "completedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "reportId",
            "in": "path",
            "required": true,
            "description": "报告 ID。",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "forceRefresh": {
                    "type": "boolean",
                    "description": "是否跳过缓存重新观测，默认 false。设置为 true 会重新创建观测并消耗 credits。"
                  },
                  "includeRawResponse": {
                    "type": "boolean",
                    "description": "是否在问题排查场景保留扩展返回引用。普通业务接入建议保持 false。"
                  }
                }
              },
              "example": {
                "forceRefresh": false,
                "includeRawResponse": false
              }
            }
          }
        }
      },
      "get": {
        "summary": "搜索可见性观测任务列表",
        "description": "分页读取报告下的观测任务。支持按 state 过滤，按 createdAt、updatedAt、state 排序；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "list_search_visibility_runs",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "runs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "runId": {
                            "type": "string"
                          },
                          "reportId": {
                            "type": "string"
                          },
                          "state": {
                            "type": "string"
                          },
                          "forceRefresh": {
                            "type": "boolean"
                          },
                          "creditCost": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "tasksTotal": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "tasksSucceeded": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "tasksFailed": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "metrics": {
                            "type": "object",
                            "properties": {
                              "queryCoverageRate": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "top10PresenceRate": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "top20PresenceRate": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "bestRank": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "averageVisibleRank": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "averageRankWithPenalty": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "competitorGap": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "sourceCoverage": {
                                "type": "object",
                                "properties": {
                                  "google_web": {
                                    "type": "integer",
                                    "format": "int32"
                                  }
                                }
                              },
                              "visibilityScore": {
                                "type": "integer",
                                "format": "int32"
                              }
                            }
                          },
                          "errorSummary": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            }
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "completedAt": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "nextPageToken": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "reportId",
            "in": "path",
            "required": true,
            "description": "报告 ID。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          },
          {
            "name": "pageToken",
            "in": "query",
            "required": false,
            "description": "分页令牌。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "过滤表达式。报告列表支持 brand/domain；任务列表支持 state；结果列表支持 source/query。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "description": "排序表达式，如 createdAt desc、updatedAt desc、checkedAt desc。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/searchVisibilityResults/{resultId}": {
      "get": {
        "summary": "获取搜索可见性观测结果",
        "description": "读取指定关键词和搜索来源的观测结果，包含排名列表、品牌匹配、竞品匹配和单项指标；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "get_search_visibility_result",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "name": {
                      "type": "string"
                    },
                    "resultId": {
                      "type": "string"
                    },
                    "reportId": {
                      "type": "string"
                    },
                    "runId": {
                      "type": "string"
                    },
                    "query": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    },
                    "checkedAt": {
                      "type": "string"
                    },
                    "cacheHit": {
                      "type": "boolean"
                    },
                    "metrics": {
                      "type": "object",
                      "properties": {
                        "visible": {
                          "type": "boolean"
                        },
                        "top10": {
                          "type": "boolean"
                        },
                        "top20": {
                          "type": "boolean"
                        },
                        "bestRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "averageRankWithPenalty": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "bestCompetitorRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "competitorGap": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "matchedUrlCount": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "visibilityScore": {
                          "type": "integer",
                          "format": "int32"
                        }
                      }
                    },
                    "observedItems": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "rank": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "title": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "brandMatches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "rank": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "url": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          },
                          "registrableDomain": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "competitorMatches": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "rank": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "url": {
                            "type": "string"
                          },
                          "domain": {
                            "type": "string"
                          },
                          "registrableDomain": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "competitorDomain": {
                            "type": "string"
                          },
                          "competitorName": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "resultId",
            "in": "path",
            "required": true,
            "description": "观测结果 ID。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/searchVisibilityRuns/{runId}": {
      "get": {
        "summary": "获取搜索可见性观测任务",
        "description": "读取指定观测任务，适合轮询任务状态、查看 creditCost 和获取聚合指标；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "get_search_visibility_run",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "name": {
                      "type": "string"
                    },
                    "runId": {
                      "type": "string"
                    },
                    "reportId": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string"
                    },
                    "forceRefresh": {
                      "type": "boolean"
                    },
                    "creditCost": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksTotal": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksSucceeded": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "tasksFailed": {
                      "type": "integer",
                      "format": "int32"
                    },
                    "metrics": {
                      "type": "object",
                      "properties": {
                        "queryCoverageRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "top10PresenceRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "top20PresenceRate": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "bestRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "averageVisibleRank": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "averageRankWithPenalty": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "competitorGap": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "sourceCoverage": {
                          "type": "object",
                          "properties": {
                            "google_web": {
                              "type": "integer",
                              "format": "int32"
                            }
                          }
                        },
                        "visibilityScore": {
                          "type": "integer",
                          "format": "int32"
                        }
                      }
                    },
                    "errorSummary": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    },
                    "completedAt": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "runId",
            "in": "path",
            "required": true,
            "description": "观测任务 ID。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/searchVisibilityRuns/{runId}/results": {
      "get": {
        "summary": "搜索可见性观测结果列表",
        "description": "分页读取观测任务下的关键词级结果。支持按 source/query 过滤，按 checkedAt、source、query 排序；该接口不消耗搜索可见性 credits。\n接口标签：搜索可见性、SEO\n接口特性：\n- 支持 Google、Bing、Baidu 多搜索来源的关键词排名观测\n- 支持 Top10、Top20、Top50 三种观测深度，按深度折算 credits\n- 返回可见性评分、最佳排名、Top10/Top20 覆盖率和来源覆盖率\n- 支持品牌别名和竞品域名配置，输出品牌匹配和竞品差距\n- 创建报告和创建观测任务消耗 credits，读取报告、任务和结果不消耗 credits\n- credits = 关键词数量 × 各搜索来源单次消耗之和。Google/Bing 在 maxRank=10/20/50 时分别消耗 1/2/5 credits；Baidu 在 maxRank=10/20/50 时分别消耗 10/20/50 credits。例如 10 个关键词 × google_web × maxRank=20 消耗 20 credits；10 个关键词 × google_web + bing_web × maxRank=20 消耗 40 credits；10 个关键词 × baidu_web × maxRank=20 消耗 200 credits\n详情页：https://www.gugudata.com/api/details/search-visibility",
        "operationId": "list_search_visibility_results",
        "tags": [
          "搜索可见性接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/search-visibility"
        },
        "x-gugudata-api-identity": "search-visibility",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "-1",
            "title": "请求失败",
            "remark": "请求处理失败。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查传递的参数个数、取值范围和参数类型是否匹配。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 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": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "resultId": {
                            "type": "string"
                          },
                          "reportId": {
                            "type": "string"
                          },
                          "runId": {
                            "type": "string"
                          },
                          "query": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          },
                          "checkedAt": {
                            "type": "string"
                          },
                          "cacheHit": {
                            "type": "boolean"
                          },
                          "metrics": {
                            "type": "object",
                            "properties": {
                              "visible": {
                                "type": "boolean"
                              },
                              "top10": {
                                "type": "boolean"
                              },
                              "top20": {
                                "type": "boolean"
                              },
                              "bestRank": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "averageRankWithPenalty": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "bestCompetitorRank": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "competitorGap": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "matchedUrlCount": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "visibilityScore": {
                                "type": "integer",
                                "format": "int32"
                              }
                            }
                          },
                          "observedItems": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "rank": {
                                  "type": "integer",
                                  "format": "int32"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "url": {
                                  "type": "string"
                                },
                                "domain": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "brandMatches": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "rank": {
                                  "type": "integer",
                                  "format": "int32"
                                },
                                "url": {
                                  "type": "string"
                                },
                                "domain": {
                                  "type": "string"
                                },
                                "registrableDomain": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                }
                              }
                            }
                          },
                          "competitorMatches": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "rank": {
                                  "type": "integer",
                                  "format": "int32"
                                },
                                "url": {
                                  "type": "string"
                                },
                                "domain": {
                                  "type": "string"
                                },
                                "registrableDomain": {
                                  "type": "string"
                                },
                                "title": {
                                  "type": "string"
                                },
                                "competitorDomain": {
                                  "type": "string"
                                },
                                "competitorName": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "nextPageToken": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "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": "search-visibility",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/search-visibility",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "runId",
            "in": "path",
            "required": true,
            "description": "观测任务 ID。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 20
          },
          {
            "name": "pageToken",
            "in": "query",
            "required": false,
            "description": "分页令牌。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "filter",
            "in": "query",
            "required": false,
            "description": "过滤表达式。报告列表支持 brand/domain；任务列表支持 state；结果列表支持 source/query。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderBy",
            "in": "query",
            "required": false,
            "description": "排序表达式，如 createdAt desc、updatedAt desc、checkedAt desc。",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/vehicleBrands": {
      "get": {
        "summary": "汽车车型库数据",
        "description": "提供多维度汽车车型库查询能力\n接口标签：基础数据、汽车数据、车型库\n接口特性：\n- 提供品牌、车系、车型三级车型库数据查询能力\n- 支持品牌、车系、车型、年款、销售状态、车型级别和价格条件组合查询\n- 支持品牌到车系、车系到车型的稳定关联查询\n- 每周人工同步复核更新车型库数据，适合业务系统实时获取最新数据\n- 围绕“汽车车型库数据”提供标准化能力，便于快速接入现有业务\n- 适合将“汽车车型库数据”结果接入业务系统、后台工具和自动化流程\n- 适合车型库、选车工具和汽车内容产品接入\n- 支持按品牌、车系、车型等维度组织车辆资料\n详情页：https://www.gugudata.com/api/details/vehicle-catalog",
        "operationId": "get_vehicle_catalog",
        "tags": [
          "汽车车型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/vehicle-catalog"
        },
        "x-gugudata-api-identity": "vehicle-catalog",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查品牌 ID、子品牌 ID、车系 ID、年款、价格区间、销售状态和分页参数是否正确"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "900",
            "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": "object",
                      "properties": {
                        "Items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "BrandId": {
                                "type": "string",
                                "description": "品牌公开唯一 ID，可用于查询车系和车型"
                              },
                              "BrandName": {
                                "type": "string",
                                "description": "品牌名称"
                              }
                            }
                          },
                          "description": "品牌列表"
                        },
                        "PageIndex": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当前页码"
                        },
                        "PageSize": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当前每页返回数量"
                        },
                        "TotalSize": {
                          "type": "integer",
                          "format": "int32",
                          "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/v1/vehicleBrands/demo?pageIndex=1&pageSize=10"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "品牌关键词，支持品牌名称或拼音首字母模糊查询",
            "schema": {
              "type": "string"
            },
            "example": "特斯拉"
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量，默认 50，最大 100",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 50
          }
        ]
      }
    },
    "/v1/vehicleSeries": {
      "get": {
        "summary": "获取品牌下车系列表",
        "description": "根据品牌查询车系列表，可按子品牌、车型级别、销售状态和价格区间筛选\n接口标签：基础数据、汽车数据、车型库\n详情页：https://www.gugudata.com/api/details/vehicle-catalog",
        "operationId": "get_get_v1_vehicleseries",
        "tags": [
          "汽车车型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/vehicle-catalog"
        },
        "x-gugudata-api-identity": "vehicle-catalog",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查品牌 ID、子品牌 ID、车系 ID、年款、价格区间、销售状态和分页参数是否正确"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "900",
            "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": "object",
                      "properties": {
                        "Items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "SeriesId": {
                                "type": "string"
                              },
                              "BrandId": {
                                "type": "string"
                              },
                              "BrandName": {
                                "type": "string"
                              },
                              "SubBrandId": {
                                "type": "string"
                              },
                              "SubBrandName": {
                                "type": "string"
                              },
                              "SeriesName": {
                                "type": "string"
                              },
                              "CarType": {
                                "type": "string"
                              },
                              "SaleStatus": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "PageIndex": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "PageSize": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "TotalSize": {
                          "type": "integer",
                          "format": "int32"
                        }
                      },
                      "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": "vehicle-catalog",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/vehicle-catalog",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": true,
            "description": "品牌公开唯一 ID，由品牌列表接口返回",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "关键词，支持按品牌、子品牌、车系名称或车型级别模糊查询",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sub_brand_id",
            "in": "query",
            "required": false,
            "description": "子品牌公开唯一 ID，可用于限定子品牌",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "car_type",
            "in": "query",
            "required": false,
            "description": "车型级别，例如 中型SUV、中型车、紧凑型车",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sale_status",
            "in": "query",
            "required": false,
            "description": "销售状态，支持 在售、停售、未上市、即将上市",
            "schema": {
              "type": "string",
              "enum": [
                "在售",
                "停售",
                "未上市",
                "即将上市"
              ]
            }
          },
          {
            "name": "official_price_min",
            "in": "query",
            "required": false,
            "description": "官方指导价下限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "official_price_max",
            "in": "query",
            "required": false,
            "description": "官方指导价上限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "dealer_price_min",
            "in": "query",
            "required": false,
            "description": "经销商报价下限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "dealer_price_max",
            "in": "query",
            "required": false,
            "description": "经销商报价上限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量，默认 50，最大 100",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          }
        ]
      }
    },
    "/v1/vehicleSeries/{seriesId}": {
      "get": {
        "summary": "获取车系详情",
        "description": "根据车系公开唯一 ID 获取单个车系详情\n接口标签：基础数据、汽车数据、车型库\n详情页：https://www.gugudata.com/api/details/vehicle-catalog",
        "operationId": "get_get_v1_vehicleseries_seriesid",
        "tags": [
          "汽车车型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/vehicle-catalog"
        },
        "x-gugudata-api-identity": "vehicle-catalog",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查品牌 ID、子品牌 ID、车系 ID、年款、价格区间、销售状态和分页参数是否正确"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "900",
            "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": "object",
                      "properties": {
                        "SeriesId": {
                          "type": "string"
                        },
                        "BrandId": {
                          "type": "string"
                        },
                        "BrandName": {
                          "type": "string"
                        },
                        "SubBrandId": {
                          "type": "string"
                        },
                        "SubBrandName": {
                          "type": "string"
                        },
                        "SeriesName": {
                          "type": "string"
                        },
                        "CarType": {
                          "type": "string"
                        },
                        "SaleStatus": {
                          "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": "vehicle-catalog",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/vehicle-catalog",
        "parameters": [
          {
            "name": "seriesId",
            "in": "path",
            "required": true,
            "description": "车系公开唯一 ID，路径参数",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          }
        ]
      }
    },
    "/v1/vehicleTrims": {
      "get": {
        "summary": "获取车型列表",
        "description": "查询车型列表，可按品牌、子品牌、车系、年款、销售状态和价格区间筛选\n接口标签：基础数据、汽车数据、车型库\n详情页：https://www.gugudata.com/api/details/vehicle-catalog",
        "operationId": "get_get_v1_vehicletrims",
        "tags": [
          "汽车车型接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/vehicle-catalog"
        },
        "x-gugudata-api-identity": "vehicle-catalog",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查品牌 ID、子品牌 ID、车系 ID、年款、价格区间、销售状态和分页参数是否正确"
          },
          {
            "code": "504",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否正确"
          },
          {
            "code": "900",
            "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": "object",
                      "properties": {
                        "Items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "TrimId": {
                                "type": "string"
                              },
                              "SeriesId": {
                                "type": "string"
                              },
                              "SeriesName": {
                                "type": "string"
                              },
                              "BrandId": {
                                "type": "string"
                              },
                              "SubBrandId": {
                                "type": "string"
                              },
                              "TrimName": {
                                "type": "string"
                              },
                              "Year": {
                                "type": "integer",
                                "format": "int32"
                              },
                              "SaleStatus": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "PageIndex": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "PageSize": {
                          "type": "integer",
                          "format": "int32"
                        },
                        "TotalSize": {
                          "type": "integer",
                          "format": "int32"
                        }
                      },
                      "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": "vehicle-catalog",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/vehicle-catalog",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "series_id",
            "in": "query",
            "required": false,
            "description": "车系公开唯一 ID，可用于限定车系",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "关键词，支持按品牌、子品牌、车系、车型或车名模糊查询",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": false,
            "description": "品牌公开唯一 ID，可用于限定品牌",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sub_brand_id",
            "in": "query",
            "required": false,
            "description": "子品牌公开唯一 ID，可用于限定子品牌",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "description": "年款，例如 2025",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "year_min",
            "in": "query",
            "required": false,
            "description": "年款下限，例如 2024",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "year_max",
            "in": "query",
            "required": false,
            "description": "年款上限，例如 2026",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "sale_status",
            "in": "query",
            "required": false,
            "description": "销售状态，支持 在售、停售、未上市、即将上市",
            "schema": {
              "type": "string",
              "enum": [
                "在售",
                "停售",
                "未上市",
                "即将上市"
              ]
            }
          },
          {
            "name": "official_price_min",
            "in": "query",
            "required": false,
            "description": "官方指导价下限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "official_price_max",
            "in": "query",
            "required": false,
            "description": "官方指导价上限，单位万元",
            "schema": {
              "type": "number"
            },
            "example": 0
          },
          {
            "name": "pageIndex",
            "in": "query",
            "required": false,
            "description": "页码，从 1 开始",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "每页返回数量，默认 50，最大 100",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 0
          }
        ]
      }
    },
    "/v2/finance/currency-exchange": {
      "get": {
        "summary": "国际货币汇率",
        "description": "支持多种货币对\n接口标签：基础数据、货币、每日精准汇率、多币种支持\n接口特性：\n- 支持多种货币汇率查询\n- 支持部分加密货币汇率查询\n- 数据为每日更新汇率数据\n- 可一次查询源货币代码对应所有目标货币汇率\n- 秒级查询性能，支持高并发\n- 围绕“国际货币汇率”提供标准化能力，便于快速接入现有业务\n- 适合将“国际货币汇率”结果接入业务系统、后台工具和自动化流程\n- 适合行情看板、投研系统和自动化数据任务接入\n详情页：https://www.gugudata.com/api/details/currencyexchange",
        "operationId": "get_currencyexchange",
        "tags": [
          "股票证券接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/currencyexchange"
        },
        "x-gugudata-api-identity": "currencyexchange",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "500",
            "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": "此条件下的总数据量，一般用于分页计算"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "sourceCurrency": {
                          "type": "string",
                          "description": "源货币代码"
                        },
                        "targetCurrency": {
                          "type": "object",
                          "properties": {
                            "sourceCurrency": {
                              "type": "string",
                              "description": "汇率结果：源货币代码"
                            },
                            "targetCurrency": {
                              "type": "string",
                              "description": "汇率结果：目标货币代码"
                            },
                            "exchangeRate": {
                              "type": "number",
                              "description": "汇率结果：汇率"
                            },
                            "lastUpdateTimestamp": {
                              "type": "string",
                              "description": "汇率结果：最后更新时间戳"
                            }
                          }
                        },
                        "lastUpdateTimestamp": {
                          "type": "string",
                          "description": "最后更新时间戳"
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/finance/currency-exchange/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "source",
            "in": "query",
            "required": true,
            "description": "源货币代码，例如：USD，支持的货币：$MYRO(myro) | $WEN(wen) | 00(00 token) | 1000SATS(1000sats) | 1INCH(1inch) | AAVE(aave) | ABT(arcblock) | ACH(alchemy pay) | ACS(acryptos) | ADA(cardano) | AED(emirati dirham) | AERGO(aergo) | AERO(aero coin) | AFN(afghan afghani) | AGIX(singularitynet) | AGLD(adventure gold) | AI(flourishing ai) | AIOZ(aioz network) | AKT(akash network) | ALCX(alchemix) | ALEPH(aleph.im) | ALEX(alexandrite) | ALGO(algorand) | ALICE(my neighbor alice) | ALL(albanian lek) | ALPH(alephium) | ALT(altcoin) | ALUSD(alchemix usd) | AMD(armenian dram) | AMP(amp) | ANG(dutch guilder) | ANKR(ankr network) | ANT(aragon) | AOA(angolan kwanza) | APE(apecoin) | APEX(apexcoin) | API3(api3) | APT(aptos) | AR(arweave) | ARB(arbitrum) | ARK(ark) | ARKM(arkm) | ARPA(arpa chain) | ARS(argentine peso) | ASM(assemble protocol) | AST(airswap) | ASTR(astar) | ATA(automata network) | ATOM(cosmos) | ATS(austrian schilling) | AUCTION(bounce token auction) | AUD(australian dollar) | AUDIO(audius) | AURORA(aurora) | AVAX(avalanche) | AVT(aventus) | AWG(aruban or dutch guilder) | AXL(axelar) | AXS(axie infinity) | AZERO(aleph zero) | AZM(azerbaijani manat) | AZN(azerbaijan manat) | BABYDOGE(babydoge eth) | BADGER(badger dao) | BAKE(bakerytoken) | BAL(balancer) | BAM(bosnian convertible mark) | BAND(band protocol) | BAT(basic attention token) | BBD(barbadian or bajan dollar) | BCH(bitcoin cash) | BDT(bangladeshi taka) | BDX(beldex) | BEAM(beam) | BEF(belgian franc) | BGB(bitget token) | BGN(bulgarian lev) | BHD(bahraini dinar) | BICO(biconomy) | BIF(burundian franc) | BIGTIME(bigtime) | BIT(bitdao) | BLD(bld) | BLUR(blur) | BLZ(bluzelle) | BMD(bermudian dollar) | BNB(binance coin) | BND(bruneian dollar) | BNT(bancor network) | BOB(bolivian bolíviano) | BOBA(boba network) | BOND(barnbridge) | BONK(bonk) | BORA(bora) | BORG(borg) | BRL(brazilian real) | BSD(bahamian dollar) | BSV(bitcoin sv) | BSW(biswap) | BTC(bitcoin) | BTC.B(btc.b) | BTCB(bitcoin bep2) | BTG(bitcoin gold) | BTN(bhutanese ngultrum) | BTRST(braintrust) | BTT(bittorrent) | BUSD(binance usd) | BWP(botswana pula) | BYN(belarusian ruble) | BYR(belarusian ruble) | BZD(belizean dollar) | C98(coin98) | CAD(canadian dollar) | CAKE(pancakeswap) | CANTO(canto) | CBETH(coinbase wrapped staked eth) | CDAI(compound dai) | CDF(congolese franc) | CDT(blox) | CELO(celo) | CELR(celer network) | CETH(ceth) | CFG(centrifuge) | CFX(conflux) | CGLD(celo gold) | CHEEL(cheel) | CHF(swiss franc) | CHR(chromia) | CHZ(chiliz) | CKB(nervos network) | CLP(chilean peso) | CLV(clover finance) | CNH(chinese yuan renminbi offshore) | CNY(chinese yuan renminbi) | COMAI(comai) | COMP(compound) | COP(colombian peso) | CORE(core group asset) | CORGIAI(corgiai) | COTI(coti) | COVAL(coval) | CQT(covalent) | CRC(costa rican colon) | CRO(crypto.com chain) | CRPT(crypterium) | CRV(curve dao token) | CSPR(casper) | CTC(cartercoin) | CTSI(cartesi) | CTX(cryptex finance) | CUC(cuban convertible peso) | CUP(cuban peso) | CVC(civic) | CVE(cape verdean escudo) | CVX(convex finance) | CWBTC(cwbtc) | CYP(cypriot pound) | CZK(czech koruna) | DAG(constellation) | DAI(dai) | DAO(dao maker) | DAR(mines of dalarnia) | DASH(digital cash) | DCR(decred) | DDX(derivaDAO) | DEM(german deutsche mark) | DESO(decentralized social) | DEXE(dexe) | DEXT(dextools) | DFI(dfistarter) | DIA(dia) | DIMO(dimo) | DJF(djiboutian franc) | DKK(danish krone) | DNT(district0x) | DOGE(dogecoin) | DOP(dominican peso) | DORA(dora factory) | DOT(polkadot) | DREP(drep [new]) | DYDX(dydx) | DYM(dym) | DYP(defi yield protocol) | DZD(algerian dinar) | EDU(educoin) | EDUM(edum) | EEK(estonian kroon) | EGLD(elrond) | EGP(egyptian pound) | ELA(elastos) | ELF(aelf) | ELG(escoinToken) | ENJ(enjin coin) | ENS(ethereum name service) | EOS(eos) | ERN(eritrean nakfa) | ESP(spanish peseta) | ETB(ethiopian birr) | ETC(ethereum classic) | ETH(ethereum) | ETH2(ethereum 2.0) | ETHDYDX(ethdydx) | ETHW(ethw) | ETHX(ethx) | EUR(euro) | EUROC(euro coin) | EVER(everLife.AI) | FDUSD(fdusd) | FEI(fei usd) | FET(fetch.ai) | FIDA(bonfida) | FIL(filecoin) | FIM(finnish markka) | FIS(stafi) | FJD(fijian dollar) | FKP(falkland island pound) | FLOKI(baby moon floki) | FLOW(flow) | FLR(flare) | FLUX(datamine flux) | FNSA(fnsa) | FORT(forta) | FORTH(ampleforth governance token) | FOX(shapeshift fox token) | FRAX(frax) | FRF(french franc) | FRXETH(frxeth) | FTM(fantom) | FTN(ftn) | FTT(farmatrust) | FX(function x) | FXS(frax share) | GAJ(gaj finance) | GAL(project galaxy) | GALA(gala) | GAS(gas) | GBP(british pound) | GEL(georgian lari) | GFI(goldfinch) | GGP(guernsey pound) | GHC(ghanaian cedi) | GHS(ghanaian cedi) | GHST(aavegotchi) | GIP(gibraltar pound) | GLM(golem) | GLMR(moonbeam) | GMD(gambian dalasi) | GMT(stepn) | GMX(goldmaxcoin) | GNF(guinean franc) | GNO(gnosis) | GNS(gains network) | GNT(greentrust) | GODS(gods unchained) | GRD(greek drachma) | GRT(the graph) | GST(green satoshi token) | GT(gatetoken) | GTC(gitcoin) | GTQ(guatemalan quetzal) | GUSD(gemini us dollar) | GXC(gx coin) | GYD(guyanese dollar) | GYEN(gyen) | HBAR(hedera) | HBTC(huobi btc) | HFT(hashflow) | HIGH(highstreet) | HKD(hong kong dollar) | HNL(honduran lempira) | HNT(helium) | HONEY(honey) | HOPR(hopr) | HOT(hydro protocol) | HRK(croatian kuna) | HT(huobi token) | HTG(haitian gourde) | HUF(hungarian forint) | ICP(internet computer) | ICX(icon project) | ID(trigid) | IDEX(idex) | IDR(indonesian rupiah) | IEP(irish pound) | ILS(israeli shekel) | ILV(illuvium) | IMP(isle of man pound) | IMX(immutable x) | INDEX(index cooperative) | INJ(injective) | INR(indian rupee) | INV(inverse finance) | IOST(ios token) | IOTA(iota) | IOTX(iotex) | IQD(iraqi dinar) | IRR(iranian rial) | ISK(icelandic krona) | ITL(italian lira) | JASMY(jasmy) | JEP(jersey pound) | JMD(jamaican dollar) | JOD(jordanian dinar) | JOE(joe) | JPY(japanese yen) | JST(just) | JTO(jto) | JUP(jupiter) | KAS(kas) | KAVA(kava) | KCS(kucoin) | KDA(kadena) | KEEP(keep network) | KES(kenyan shilling) | KGS(kyrgyzstani som) | KHR(cambodian riel) | KLAY(klaytn) | KMF(comorian franc) | KNC(kyber network crystals) | KPW(north korean won) | KRL(kryll) | KRW(south korean won) | KSM(kusama) | KUB(bitkub coin) | KUJI(kujira) | KWD(kuwaiti dinar) | KYD(caymanian dollar) | KZT(kazakhstani tenge) | LAK(lao kip) | LBP(lebanese pound) | LCX(lcx) | LDO(lido dao token) | LEO(leocoin) | LINK(chainlink) | LIT(litentry) | LKR(sri lankan rupee) | LOKA(league of kingdoms arena) | LOOM(loom network) | LPT(livepeer (lpt)) | LQTY(liquity) | LRC(loopring) | LRD(liberian dollar) | LSETH(liquid staked ethereum) | LSK(lisk) | LSL(basotho loti) | LTC(litecoin) | LTL(lithuanian litas) | LUF(luxembourg franc) | LUNA(terra) | LUNC(lunc) | LUSD(limited usd) | LVL(latvian lat) | LYD(libyan dinar) | LYX(lyx) | LYXE(lukso) | MAD(moroccan dirham) | MAGIC(magic) | MANA(mana coin decentraland) | MANTA(manta) | MASK(mask network) | MATH(math) | MATIC(polygon) | MAV(mav) | MAVIA(mavia) | MBX(mobiecoin) | MCO2(moss carbon credit) | MDL(moldovan leu) | MDT(measurable data token) | MEDIA(media network) | MEME(pepe) | METH(mirrored ether) | METIS(metisDAO) | MGA(malagasy ariary) | MGF(malagasy franc) | MINA(mina) | MIR(mirror protocol) | MKD(macedonian denar) | MKR(maker) | MKUSD(mkusd) | MLN(enzyme) | MMK(burmese kyat) | MNDE(marinade) | MNT(mongolian tughrik) | MOBILE(mobile) | MOG(mog) | MONA(monavale) | MOP(macau pataca) | MOVR(moonriver) | MPL(maple) | MRO(mauritanian ouguiya) | MRU(mauritanian ouguiya) | MSOL(marinade staked sol) | MTL(maltese lira) | MUBI(mubi) | MULTI(multichain) | MUR(mauritian rupee) | MUSE(muse) | MVR(maldivian rufiyaa) | MWK(malawian kwacha) | MX(marsx) | MXC(mxc) | MXN(mexican peso) | MXV(mxv) | MYR(malaysian ringgit) | MZM(mozambican metical) | MZN(mozambican metical) | NAD(namibian dollar) | NCT(polyswarm) | NEAR(near protocol) | NEO(neo) | NEON(neon) | NEST(nest protocol) | NEXO(nexo) | NFT(nft) | NGN(nigerian naira) | NIO(nicaraguan cordoba) | NKN(nkn) | NLG(dutch guilder) | NMR(numeraire network) | NOK(norwegian krone) | NOS(nos) | NPR(nepalese rupee) | NTRN(neutron) | NU(nucypher) | NXM(nxm) | NZD(new zealand dollar) | OAS(oas) | OCEAN(ocean protocol) | OGN(origin token) | OHM(olympus v1) | OKB(okex) | OKT(oec token) | OLAS(olas) | OM(mantra dao) | OMG(omisego) | OMI(ecomi) | OMR(omani rial) | ONDO(ondo) | ONE(menlo one) | ONT(ontology) | OOKI(ooki protocol) | OP(optimism) | ORCA(orca) | ORDI(ordi) | ORN(orion protocol) | OSMO(osmosis) | OX(betbox) | OXT(orchid network) | PAAL(paal) | PAB(panamanian balboa) | PANDORA(pandora) | PAX(paxos standard token) | PAXG(pax gold) | PEN(peruvian sol) | PENDLE(pendle) | PEOPLE(constitutionDAO) | PEPE(pepe) | PERP(perpetual protocol) | PGK(papua new guinean kina) | PHP(philippine peso) | PIXEL(pixelverse) | PKR(pakistani rupee) | PLA(playdapp) | PLN(polish zloty) | PLU(pluton) | PNG(pangolin) | POKT(pocket network) | POLS(polkastarter) | POLY(polymath) | POLYX(polyx) | POND(marlin) | PORK(pork) | PORTAL(portal) | POWR(powerledger) | PRIME(echelon prime) | PRO(propy) | PROM(prometeus) | PRQ(parsiq) | PTE(portuguese escudo) | PUNDIX(pundi x (new)) | PYG(paraguayan guarani) | PYR(vulcan forged pyr) | PYTH(pyth) | PYUSD(pyusd) | QAR(qatari riyal) | QI(benqi) | QNT(quant) | QSP(quantstamp) | QTUM(qtum) | QUICK(quickswap) | RAD(radicle) | RAI(rai reflex index) | RARE(superRare) | RARI(rarible) | RAY(raydium) | RBN(ribbon finance) | REN(renbtc) | RENDER(render) | REP(augur) | REPV2(repv2) | REQ(request) | RETH(rocket pool eth) | RGT(rari governance token) | RIF(rif token) | RLB(rlb) | RLC(iexec rlc) | RLY(rally) | RNDR(render token) | ROL(romanian leu) | RON(romanian leu) | ROSE(oasis network) | RPL(rocket pool) | RSD(serbian dinar) | RUB(russian ruble) | RUNE(thorchain (erc20)) | RVN(ravencoin) | RWF(rwandan franc) | SAND(the sandbox) | SAR(saudi arabian riyal) | SATS(satoshi) | SAVAX(savax) | SBD(solomon islander dollar) | SC(siacoin) | SCR(seychellois rupee) | SDD(sudanese dinar) | SDG(sudanese pound) | SEAM(seam) | SEI(sei) | SEK(swedish krona) | SFP(safepal) | SFRXETH(sfrxeth) | SFUND(seedify.fund) | SGB(subgame) | SGD(singapore dollar) | SHDW(genesysgo shadow) | SHIB(shiba inu) | SHP(saint helenian pound) | SHPING(shping coin) | SIT(slovenian tolar) | SKK(slovak koruna) | SKL(skale network) | SLE(sierra leonean leone) | SLL(sierra leonean leone) | SLP(smooth love potion) | SNT(status network) | SNX(synthetix network) | SOL(solana) | SOS(somali shilling) | SPA(sperax) | SPELL(spell token) | SPL(seborgan luigino) | SRD(surinamese dollar) | SRG(surinamese guilder) | SSP(south sudanese pound) | SSV(ssvcoin) | STD(sao tomean dobra) | STETH(lido steth) | STG(stargate finance) | STN(sao tomean dobra) | STORJ(storj) | STRAX(stratis) | STRD(strd) | STRK(strike) | STSOL(lido for solana) | STX(stacks) | SUI(sui) | SUKU(suku) | SUPER(superfarm) | SUSHI(sushiswap) | SVC(salvadoran colon) | SWETH(sweth) | SWFTC(swftcoin) | SXP(swipe) | SYLO(sylo) | SYN(synapse) | SYP(syrian pound) | SZL(swazi lilangeni) | T(threshold) | TAO(tao) | TET(tet) | TFUEL(theta fuel) | THB(thai baht) | THETA(theta) | TIA(tianhe) | TIME(chrono.tech) | TJS(tajikistani somoni) | TKX(token x) | TMM(turkmenistani manat) | TMT(turkmenistani manat) | TND(tunisian dinar) | TON(tokamak network) | TONE(te-food) | TOP(tongan pa'anga) | TOPIA(topia) | TOR(torcoin) | TRAC(origintrail) | TRB(tellor) | TRIBE(tribe) | TRL(turkish lira) | TRU(truefi) | TRUMP(trumpcoin) | TRX(tron) | TRY(turkish lira) | TTD(trinidadian dollar) | TTT(tap project) | TUSD(true usd) | TVD(tuvaluan dollar) | TVK(terra virtua kolect) | TWD(taiwan new dollar) | TWT(trust wallet token) | TZS(tanzanian shilling) | UAH(ukrainian hryvnia) | UGX(ugandan shilling) | UMA(universal market access) | UNFI(unifi protocol dao) | UNI(uniswap) | UOS(ultra) | UPI(pawtocol) | UQC(uquid coin) | USD(us dollar) | USDC(usdc) | USDD(usdd) | USDE(unitarystatus dollar) | USDP(usdp stablecoin) | USDT(tether) | UST(terrausd) | USTC(ustc) | UYU(uruguayan peso) | UZS(uzbekistani som) | VAL(vatican city lira) | VARA(vara) | VEB(venezuelan bolívar) | VED(ved) | VEF(venezuelan bolívar) | VELO(velo) | VES(venezuelan bolívar) | VET(vechain) | VGX(voyager token) | VND(vietnamese dong) | VNST(vnst) | VOXEL(voxies) | VR(victoria vr) | VTHO(vechainthor) | VUV(ni-vanuatu vatu) | WAMPL(wrapped ampleforth) | WAVES(waves) | WAXL(axelar) | WAXP(wax) | WBETH(wbeth) | WBT(wbt) | WBTC(wrapped bitcoin) | WCFG(wrapped centrifuge) | WEMIX(wemix) | WRH(whrh) | WIF(wif) | WLD(wld) | WLUNA(wrapped luna) | WOO(woo network) | WST(samoan tala) | XAF(central african cfa franc beac) | XAG(silver ounce) | XAI(sapiencecoin) | XAU(gold ounce) | XAUT(tether gold) | XBT(xbt) | XCD(east caribbean dollar) | XCH(chia) | XCN(chain) | XDC(xdc network) | XDR(imf special drawing rights) | XEC(eternal coin) | XEM(nem) | XLM(stellar lumen) | XMON(xmon) | XMR(monero) | XOF(cfa franc) | XPD(palladium ounce) | XPF(cfp franc) | XPT(platinum ounce) | XRD(radix) | XRP(ripple) | XTZ(tezos) | XVS(venus) | XYO(xyo network) | YER(yemeni rial) | YFI(yearn finance) | YFII(dfi.money) | ZAR(south african rand) | ZEC(zcash) | ZEN(horizen) | ZETA(zeta) | ZIL(zilliqa) | ZMK(zambian kwacha) | ZMW(zambian kwacha) | ZRX(zrx 0x) | ZWD(zimbabwean dollar) | ZWL(zimbabwean dollar)",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/api/details/currency-exchange"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/api/details/currency-exchange",
            "example": "YOUR_VALUE"
          },
          {
            "name": "target",
            "in": "query",
            "required": false,
            "description": "目标货币代码，例如：CNY，不传递则返回所有支持的货币对",
            "schema": {
              "type": "string",
              "x-gugudata-enum-source": "https://www.gugudata.com/api/details/currency-exchange"
            },
            "x-gugudata-enum-source": "https://www.gugudata.com/api/details/currency-exchange",
            "example": "YOUR_VALUE"
          },
          {
            "name": "date",
            "in": "query",
            "required": false,
            "description": "固定某日的历史汇率，格式为 yyyy-mm-dd，如 2024-01-01，目前仅支持最近 2～3 天的历史数据，不传递则返回实时汇率。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/v2/location/country": {
      "get": {
        "summary": "国家地区基础信息数据",
        "description": "全球国家地区基础资料查询\n接口标签：基础数据、最新基础信息、支持多维度筛选\n接口特性：\n- 支持查询国家和地区的基础元数据\n- languages 可用于按语言代码筛选结果，例如 zh、en\n- 返回字段采用 v2 响应格式，dataStatus 和 data 字段为小驼峰命名\n- 适合国家地区选择器、电话区号补全、跨境业务资料库和地理维度分析等场景\n- 围绕“国家地区基础信息数据”提供标准化能力，便于快速接入现有业务\n- 适合将“国家地区基础信息数据”结果接入业务系统、后台工具和自动化流程\n- 适合地址解析、区域筛选、机构网点管理和地图类产品接入\n- 可与行政区划、坐标转换和 IP 定位接口组合使用\n详情页：https://www.gugudata.com/api/details/metacountry",
        "operationId": "get_metacountry",
        "tags": [
          "区域坐标与定位接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/metacountry"
        },
        "x-gugudata-api-identity": "metacountry",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": "此条件下的数据总量。"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "alphaTwoCode": {
                          "type": "string",
                          "description": "ISO 3166-1 二位国家或地区代码。"
                        },
                        "alphaThreeCode": {
                          "type": "string",
                          "description": "ISO 3166-1 三位国家或地区代码。"
                        },
                        "name": {
                          "type": "string",
                          "description": "英文名称。"
                        },
                        "nativeName": {
                          "type": "string",
                          "description": "本地语言名称。"
                        },
                        "emoji": {
                          "type": "string",
                          "description": "国家或地区旗帜 emoji。"
                        },
                        "phonePrefix": {
                          "type": "string",
                          "description": "国际电话区号。"
                        },
                        "continent": {
                          "type": "string",
                          "description": "所属洲。"
                        },
                        "capital": {
                          "type": "string",
                          "description": "首都或首府。"
                        },
                        "currencies": {
                          "type": "string",
                          "description": "货币代码，多个值用分隔符表示。"
                        },
                        "languages": {
                          "type": "string",
                          "description": "语言代码，多个值用分隔符表示。"
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/location/country/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "languages",
            "in": "query",
            "required": false,
            "description": "语言代码筛选条件，例如 zh、en；为空时返回默认范围。",
            "schema": {
              "type": "string"
            },
            "example": "zh"
          }
        ]
      }
    },
    "/v2/location/ip": {
      "get": {
        "summary": "国际 IP 地址定位",
        "description": "兼容 IPv4 与 IPv6\n接口标签：网络工具、IP地址、兼容 IPv4/IPv6、全球 IP 地址定位\n接口特性：\n- 支持全球 IP 地址定位查询\n- 每周定时更新最新定位基础数据库\n- 提供精准、高效的 IPv4/IPv6 地址定位查询\n- 一个接口同时兼容 IPv4 或 IPv6 地址的查询定位\n- 返回的 IP 定位地址包含详细的位置信息\n- 围绕“国际 IP 地址定位”提供标准化能力，便于快速接入现有业务\n- 适合将“国际 IP 地址定位”结果接入业务系统、后台工具和自动化流程\n- 适合地址解析、区域筛选、机构网点管理和地图类产品接入\n详情页：https://www.gugudata.com/api/details/internationaliplocation",
        "operationId": "get_internationaliplocation",
        "tags": [
          "区域坐标与定位接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/internationaliplocation"
        },
        "x-gugudata-api-identity": "internationaliplocation",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": "此条件下的总数据量，一般用于分页计算"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "countryCode": {
                          "type": "string",
                          "description": "IP 地址定位国家代码"
                        },
                        "state": {
                          "type": "string",
                          "description": "IP 地址定位省份/州"
                        },
                        "city": {
                          "type": "string",
                          "description": "IP 地址定位城市"
                        },
                        "latitude": {
                          "type": "number",
                          "description": "IP 地址定位纬度"
                        },
                        "longitude": {
                          "type": "number",
                          "description": "IP 地址定位经度"
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/location/ip/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "ip",
            "in": "query",
            "required": true,
            "description": "IP 地址，可以传递 IPv4 或 IPv6 地址",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/v2/websitetools/dns-lookup": {
      "get": {
        "summary": "域名 DNS 信息查询",
        "description": "多种记录类型数据返回\n接口标签：网络工具、丰富信息结构、毫秒级响应\n接口特性：\n- 提供域名 DNS 解析完整记录\n- 丰富的解析记录类型，包括：A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA\n- 支持多种解析记录类型的查询\n- 毫秒级解析性能，支持高并发\n- 围绕“域名 DNS 信息查询”提供标准化能力，便于快速接入现有业务\n- 适合将“域名 DNS 信息查询”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/dnslookup",
        "operationId": "get_dnslookup",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/dnslookup"
        },
        "x-gugudata-api-identity": "dnslookup",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": "HTTP状态码"
                        },
                        "status": {
                          "type": "string",
                          "description": "请求状态"
                        },
                        "statusDescription": {
                          "type": "string",
                          "description": "请求状态的描述"
                        },
                        "responseDateTime": {
                          "type": "string",
                          "description": "响应时间"
                        },
                        "dataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "返回数据的总条数"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "*": {
                          "description": "解析记录类型，包括：A, AAAA, MX, TXT, NS, CNAME, SRV, PTR, SOA",
                          "type": "object",
                          "properties": {
                            "domain": {
                              "type": "string",
                              "description": "解析的域名"
                            },
                            "ttl": {
                              "type": "string",
                              "description": "解析记录的 TTL"
                            },
                            "class": {
                              "type": "string",
                              "description": "解析记录的类别"
                            },
                            "type": {
                              "type": "string",
                              "description": "解析记录的类型"
                            },
                            "value": {
                              "type": "string",
                              "description": "解析记录的值"
                            }
                          }
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/websitetools/dns-lookup/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "需要解析的域名，格式为 gugudata.com",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/v2/websitetools/sslcertinfo": {
      "get": {
        "summary": "域名 SSL 证书信息解析",
        "description": "提供域名 SSL 证书信息解析\n接口标签：网络工具、多信息查询、毫秒级响应\n接口特性：\n- 提供域名 SSL 证书信息解析\n- 最完整 SSL 属性信息解析\n- 支持多种元素信息抽取，包括主题的可辨识名称、颁发者的可辨识名称、序列号、有效起始日期、有效结束日期、签名算法、公钥信息、密钥用法、扩展密钥用法、基本约束、主题备用名称、颁发者备用名称、证书版本、证书签名、公钥算法、证书扩展信息\n- 毫秒级解析性能，支持高并发\n- 围绕“域名 SSL 证书信息解析”提供标准化能力，便于快速接入现有业务\n- 适合将“域名 SSL 证书信息解析”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/sslcertinfo",
        "operationId": "get_sslcertinfo",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/sslcertinfo"
        },
        "x-gugudata-api-identity": "sslcertinfo",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": "HTTP状态码"
                        },
                        "status": {
                          "type": "string",
                          "description": "请求状态"
                        },
                        "statusDescription": {
                          "type": "string",
                          "description": "请求状态的描述"
                        },
                        "responseDateTime": {
                          "type": "string",
                          "description": "响应时间"
                        },
                        "dataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "返回数据的总条数"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "subjectDN": {
                          "type": "string",
                          "description": "主题的可辨识名称"
                        },
                        "issuerDN": {
                          "type": "string",
                          "description": "颁发者的可辨识名称"
                        },
                        "serialNumber": {
                          "type": "string",
                          "description": "序列号"
                        },
                        "validFrom": {
                          "type": "string",
                          "description": "有效起始日期"
                        },
                        "validTo": {
                          "type": "string",
                          "description": "有效结束日期"
                        },
                        "signatureAlgorithm": {
                          "type": "string",
                          "description": "签名算法"
                        },
                        "publicKey": {
                          "type": "string",
                          "description": "公钥信息"
                        },
                        "keyUsage": {
                          "type": "string",
                          "description": "密钥用法"
                        },
                        "extendedKeyUsage": {
                          "type": "string",
                          "description": "扩展密钥用法"
                        },
                        "basicConstraints": {
                          "type": "string",
                          "description": "基本约束"
                        },
                        "subjectAlternativeNames": {
                          "type": "string",
                          "description": "主题备用名称"
                        },
                        "issuerAlternativeNames": {
                          "type": "string",
                          "description": "颁发者备用名称"
                        },
                        "version": {
                          "type": "string",
                          "description": "证书版本"
                        },
                        "signature": {
                          "type": "string",
                          "description": "证书签名"
                        },
                        "publicKeyAlgorithm": {
                          "type": "string",
                          "description": "公钥算法"
                        },
                        "extensions": {
                          "type": "string",
                          "description": "证书扩展信息"
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/websitetools/sslcertinfo/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "需要解析的域名，格式为 https://www.gugudata.com",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/v2/websitetools/whois": {
      "get": {
        "summary": "域名 Whois 查询",
        "description": "域名注册档案与到期信息查询\n接口标签：网络工具、精准 Whois 数据、实时数据\n接口特性：\n- 支持按域名查询 Whois 注册信息\n- domain 只需传入域名本身，不需要包含 http 或 https\n- 返回字段采用 v2 响应格式，dataStatus 和 data 字段为小驼峰命名\n- 适合域名资产盘点、注册信息核查、过期时间提醒和安全风控等场景\n- 围绕“域名 Whois 查询”提供标准化能力，便于快速接入现有业务\n- 适合将“域名 Whois 查询”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/whois",
        "operationId": "get_whois",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/whois"
        },
        "x-gugudata-api-identity": "whois",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": "此条件下的数据总量。"
                        }
                      }
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "domain_name": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "域名名称。"
                        },
                        "registrar": {
                          "type": "string",
                          "description": "注册商。"
                        },
                        "creation_date": {
                          "type": "string",
                          "description": "域名创建时间。"
                        },
                        "expiration_date": {
                          "type": "string",
                          "description": "域名过期时间。"
                        },
                        "updated_date": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "域名更新时间。"
                        },
                        "name_servers": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "域名服务器列表。"
                        },
                        "status": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "域名状态列表。"
                        },
                        "emails": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "公开联系邮箱列表。"
                        },
                        "country": {
                          "type": "string",
                          "description": "注册国家或地区代码。"
                        },
                        "state": {
                          "type": "string",
                          "description": "注册省份或州。"
                        },
                        "city": {
                          "type": "string",
                          "description": "注册城市。"
                        },
                        "org": {
                          "type": "string",
                          "description": "注册组织。"
                        },
                        "dnssec": {
                          "type": "string",
                          "description": "DNSSEC 状态。"
                        },
                        "referral_url": {
                          "type": "string",
                          "description": "注册商参考链接。"
                        }
                      }
                    },
                    "DataStatus": {
                      "description": "接口业务状态信息。",
                      "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": "本次响应数据总数或分页总数。"
                        }
                      }
                    },
                    "Data": {
                      "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/v2/websitetools/whois/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "description": "需要查询的域名，不需要带 http 或 https 协议。",
            "schema": {
              "type": "string"
            },
            "example": "gugudata.com"
          }
        ]
      }
    },
    "/weather/lunarcalendar": {
      "get": {
        "summary": "农历与二十四节气",
        "description": "任意日期查询\n接口标签：基础数据、农历日期返回、全年节气\n接口特性：\n- 支持任意日期的农历与二十四节气查询\n- 节气包含当日、下一个以及全年节气与日期\n- 同时返回农历中文\n- 围绕“农历与二十四节气”提供标准化能力，便于快速接入现有业务\n- 适合将“农历与二十四节气”结果接入业务系统、后台工具和自动化流程\n- 适合出行服务、城市看板和生活服务页面接入\n- 可与天气、空气质量、日出日落和农历接口组合展示\n- 支持按城市、日期或时间维度组织环境信息\n详情页：https://www.gugudata.com/api/details/lunarcalendar",
        "operationId": "get_lunarcalendar",
        "tags": [
          "天气与节气接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/lunarcalendar"
        },
        "x-gugudata-api-identity": "lunarcalendar",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每分钟请求不能超过 100 次"
          },
          {
            "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": {
                        "LunarDate": {
                          "type": "string",
                          "description": "农历日期"
                        },
                        "LunarDateChinese": {
                          "type": "string",
                          "description": "农历中文日期，如: 二零二二 壬寅 虎年 九月小初三"
                        },
                        "SolarTermNext": {
                          "type": "string",
                          "description": "下一个节气与日期，如: 寒露:10-8"
                        },
                        "SolarTermThisYear": {
                          "type": "string",
                          "description": "本年所有节气与日期，如: 立春:2-4 雨水:2-19 惊蛰:3-5 春分:3-20 清明:4-5 谷雨:4-20 立夏:5-5 小满:5-21 芒种:6-6 夏至:6-21 小暑:7-7 大暑:7-23 立秋:8-7 处暑:8-23 白露:9-7 秋分:9-23 寒露:10-8 霜降:10-23 立冬:11-7 小雪:11-22 大雪:12-7 冬至:12-22 小寒:1-5 大寒:1-20"
                        },
                        "SolarTermToday": {
                          "type": "string",
                          "description": "今日节气，如: 寒露:10-8"
                        }
                      },
                      "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/weather/lunarcalendar/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "请求转换的日期，格式为: yyyymmdd，如 20220101",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/weather/sunriseandsunset": {
      "get": {
        "summary": "日出与日落时间",
        "description": "多个天文指标\n接口标签：基础数据、全国多个城市、支持历史数据\n接口特性：\n- 支持全国多个城市精准查询\n- 多个天文曙暮光指标\n- 包含白日时长以及相对变化值\n- 返回每日正午时间点以及日地距离\n- 围绕“日出与日落时间”提供标准化能力，便于快速接入现有业务\n- 适合将“日出与日落时间”结果接入业务系统、后台工具和自动化流程\n- 适合出行服务、城市看板和生活服务页面接入\n- 可与天气、空气质量、日出日落和农历接口组合展示\n详情页：https://www.gugudata.com/api/details/sunrisesunset",
        "operationId": "get_sunrisesunset",
        "tags": [
          "天气与节气接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/sunrisesunset"
        },
        "x-gugudata-api-identity": "sunrisesunset",
        "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": {
                        "City": {
                          "type": "string",
                          "description": "返回数据的城市名称"
                        },
                        "SunriseTime": {
                          "type": "string",
                          "description": "日出时间，格式为: hh:mm"
                        },
                        "SunsetTime": {
                          "type": "string",
                          "description": "日落时间，格式为: hh:mm"
                        },
                        "DaylightHours": {
                          "type": "string",
                          "description": "日光时间，格式为: hh:mm:ss"
                        },
                        "DaylightHoursDiff": {
                          "type": "string",
                          "description": "日光时间差，格式为: (+/-)hh:mm，+ 为较于前日增加，- 为较于前日减少"
                        },
                        "AstroTwilightStart": {
                          "type": "string",
                          "description": "天文曙暮光开始时间，格式为: hh:mm"
                        },
                        "AstroTwilightEnd": {
                          "type": "string",
                          "description": "天文曙暮光结束时间，格式为: hh:mm"
                        },
                        "NauticalTwilightStart": {
                          "type": "string",
                          "description": "航海曙暮光开始时间，格式为: hh:mm"
                        },
                        "NauticalTwilightEnd": {
                          "type": "string",
                          "description": "航海曙暮光结束时间，格式为: hh:mm"
                        },
                        "CivilTwilightStart": {
                          "type": "string",
                          "description": "民用曙暮光开始时间，格式为: hh:mm"
                        },
                        "CivilTwilightEnd": {
                          "type": "string",
                          "description": "民用曙暮光结束时间，格式为: hh:mm"
                        },
                        "SolarNoonTime": {
                          "type": "string",
                          "description": "正午时刻，格式为: hh:mm"
                        },
                        "SolarNoonDistance": {
                          "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/weather/sunriseandsunset/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "city",
            "in": "query",
            "required": true,
            "description": "查询城市名，如北京、南京、保定等",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "date",
            "in": "query",
            "required": true,
            "description": "查询的日期，格式为 yyyymmdd，如 20220701",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/weather/weatherinfo": {
      "get": {
        "summary": "全国天气预报信息",
        "description": "精确到行政区的7日天气预报\n接口标签：基础数据、日4次数据更新、多维度天气指标\n接口特性：\n- 全国天气预报数据，每隔 6 小时更新\n- 包含湿度信息\n- 精确到行政区级别的天气预报数据\n- 提供最长 7 天的天气预报数据\n- 提供每日小时级别的天气预报数据\n- 提供本地日出日落、当日历史温度等附加数据\n- 提供紫外线、穿衣、洗车、空气污染等额外指导数据\n- 围绕“全国天气预报信息”提供标准化能力，便于快速接入现有业务\n详情页：https://www.gugudata.com/api/details/weatherinfo",
        "operationId": "get_weatherinfo",
        "tags": [
          "天气与节气接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/weatherinfo"
        },
        "x-gugudata-api-identity": "weatherinfo",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每分钟请求不能超过 100 次"
          },
          {
            "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": {
                        "Code": {
                          "type": "string",
                          "description": "地区编码"
                        },
                        "WeatherDate": {
                          "type": "string",
                          "description": "天气预报的日期"
                        },
                        "WeatherRegion": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "当前天气预报的详细地区信息，数据格式与查询地区编码接口返回数据格式一致。",
                          "properties": {
                            "ReginType": {
                              "type": "string",
                              "description": "位置信息类型，2为市级别数据，3为区级别数据"
                            },
                            "Code": {
                              "type": "string",
                              "description": "地区完整编码"
                            },
                            "ProvinceCode": {
                              "type": "string",
                              "description": "省编码"
                            },
                            "ProvinceName": {
                              "type": "string",
                              "description": "省名称"
                            },
                            "CityCode": {
                              "type": "string",
                              "description": "市编码"
                            },
                            "CityName": {
                              "type": "string",
                              "description": "市名称"
                            },
                            "RegionCode": {
                              "type": "string",
                              "description": "区编码"
                            },
                            "RegionName": {
                              "type": "string",
                              "description": "区名称"
                            },
                            "TownCode": {
                              "type": "string",
                              "description": "镇编码"
                            },
                            "TownName": {
                              "type": "string",
                              "description": "镇名称"
                            }
                          }
                        },
                        "WeatherInfo": {
                          "type": "string",
                          "description": "天气情况"
                        },
                        "TemperatureHigh": {
                          "type": "integer",
                          "format": "int32",
                          "description": "最高温度"
                        },
                        "TemperatureLow": {
                          "type": "integer",
                          "format": "int32",
                          "description": "最低温度"
                        },
                        "TodayHistoryHighestTemperature": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当日历史最高温度（历史均值）"
                        },
                        "TodayHistoryLowestTemperature": {
                          "type": "integer",
                          "format": "int32",
                          "description": "当日历史最低温度（历史均值）"
                        },
                        "WeatherWindCondition1": {
                          "type": "string",
                          "description": "风向1"
                        },
                        "WeatherWindCondition2": {
                          "type": "string",
                          "description": "风向2"
                        },
                        "WeatherWindLevel": {
                          "type": "string",
                          "description": "风级"
                        },
                        "SunRiseTime": {
                          "type": "string",
                          "description": "日出时间"
                        },
                        "SunSetTime": {
                          "type": "string",
                          "description": "日落时间"
                        },
                        "WeatherPerHour": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "WeatherTime": {
                                "type": "string",
                                "description": "预报的小时时间，24小时制"
                              },
                              "WeatherInfo": {
                                "type": "string",
                                "description": "天气情况，天气情况枚举值：晴|多云|阴|阵雨|雷阵雨|雷阵雨伴有冰雹|雨夹雪|小雨|中雨|大雨|暴雨|大暴雨|特大暴雨|阵雪|小雪|中雪|大雪|暴雪|雾|冻雨|沙尘暴|小雨-中雨|中雨-大雨|大雨-暴雨|暴雨-大暴雨|大暴雨-特大暴雨|小雪-中雪|中雪-大雪|大雪-暴雪|浮尘|扬沙|强沙尘暴|霾"
                              },
                              "Temperature": {
                                "type": "string",
                                "description": "温度"
                              },
                              "Wet": {
                                "type": "integer",
                                "format": "int32",
                                "description": "空气湿度"
                              },
                              "WeatherWindCondition": {
                                "type": "string",
                                "description": "风向"
                              },
                              "WeatherWindLevel": {
                                "type": "string",
                                "description": "风级"
                              }
                            }
                          },
                          "description": "当日小时级别的天气预报数据数组"
                        },
                        "LifeHelperUV": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "UV指数"
                        },
                        "LifeHelperWear": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "穿衣指数"
                        },
                        "LifeHelperWashCar": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "洗车指数"
                        },
                        "LifeHelperAir": {
                          "type": "object",
                          "additionalProperties": true,
                          "description": "空气指数"
                        },
                        "LifeHelper": {
                          "type": "object",
                          "properties": {
                            "HelperName": {
                              "type": "string",
                              "description": "指数名称"
                            },
                            "HelperStatus": {
                              "type": "string",
                              "description": "指数状态"
                            },
                            "HelperValue": {
                              "type": "string",
                              "description": "指数值。总分：紫外线5分，穿衣7分，洗车4分，空气5分"
                            },
                            "HelperContent": {
                              "type": "string",
                              "description": "指数内容"
                            }
                          }
                        },
                        "WeatherDataGenerateDateTime": {
                          "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/weather/weatherinfo/sz"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "code",
            "in": "query",
            "required": true,
            "description": "地区编码，可通过前置接口查询获得地区编码。",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "获取天气预报的天数，默认为1，即为当天数据。最大值为7。",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1
          }
        ]
      }
    },
    "/weather/weatherinfo/region": {
      "get": {
        "summary": "查询地区编码，根据市或区的关键字进行查询，如北京、苏州、海淀、吴中等",
        "description": "包含地区编码以及省、市、区相关信息\n接口标签：基础数据、日4次数据更新、多维度天气指标\n详情页：https://www.gugudata.com/api/details/weatherinfo",
        "operationId": "get_get_weather_weatherinfo_region",
        "tags": [
          "天气与节气接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/weatherinfo"
        },
        "x-gugudata-api-identity": "weatherinfo",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每分钟请求不能超过 100 次"
          },
          {
            "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": "weatherinfo",
        "x-gugudata-parent-details-url": "https://www.gugudata.com/api/details/weatherinfo",
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "description": "",
            "schema": {
              "type": "string"
            },
            "example": "查询编码的市或区关键字，如北京、海淀"
          }
        ]
      }
    },
    "/websitetools/favicon": {
      "get": {
        "summary": "获取任意站点标题与图标",
        "description": "站点标题与图标解析\n接口标签：网络工具、兼容多种书写规则、站点路径图标\n接口特性：\n- 支持获取任意站点的标题和 favicon\n- 返回的 favicon 为站点链接\n- 围绕“获取任意站点标题与图标”提供标准化能力，便于快速接入现有业务\n- 适合将“获取任意站点标题与图标”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n- 支持将网页内容转换为便于检索和分析的结构化结果\n- 便于沉淀网页快照、资产清单和站点质量报告\n详情页：https://www.gugudata.com/api/details/favicon",
        "operationId": "get_favicon",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/favicon"
        },
        "x-gugudata-api-identity": "favicon",
        "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": {
                        "Title": {
                          "type": "string",
                          "description": "站点标题"
                        },
                        "Favicon": {
                          "type": "string",
                          "description": "站点 favicon"
                        }
                      },
                      "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/websitetools/favicon/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": "YOUR_VALUE"
          }
        ]
      }
    },
    "/websitetools/iplocation": {
      "get": {
        "summary": "国内 IP 地址定位",
        "description": "根据 IP 地址进行定位查询\n接口标签：网络工具、IP地址、兼容 IPv4/IPv6、最新数据\n接口特性：\n- 提供精准、高效的 IPv4/IPv6 地址定位查询\n- 一个接口同时兼容 IPv4 或 IPv6 地址的查询定位\n- 返回的 IP 定位地址包含详细的位置信息\n- 围绕“国内 IP 地址定位”提供标准化能力，便于快速接入现有业务\n- 适合将“国内 IP 地址定位”结果接入业务系统、后台工具和自动化流程\n- 适合地址解析、区域筛选、机构网点管理和地图类产品接入\n- 可与行政区划、坐标转换和 IP 定位接口组合使用\n- 支持按区域层级、坐标或网络地址组织查询结果\n详情页：https://www.gugudata.com/api/details/iplocation",
        "operationId": "get_iplocation",
        "tags": [
          "区域坐标与定位接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/iplocation"
        },
        "x-gugudata-api-identity": "iplocation",
        "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": {
                        "Country": {
                          "type": "string",
                          "description": "IP 地址定位所在地"
                        },
                        "Address": {
                          "type": "string",
                          "description": "IP 地址具体定位地址"
                        },
                        "LocationCode": {
                          "type": "string",
                          "description": "如有匹配，为国内地址编码，格式为：110000"
                        }
                      },
                      "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/websitetools/iplocation/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "ip",
            "in": "query",
            "required": true,
            "description": "IP 地址，可以传递 IPv4 或 IPv6 地址",
            "schema": {
              "type": "string"
            },
            "example": "YOUR_VALUE"
          }
        ]
      }
    },
    "/websitetools/pagespeed-score": {
      "get": {
        "summary": "网页性能与 SEO 评分",
        "description": "网页性能与 SEO 体验评分\n接口标签：页面评分、SEO 评分、页面性能、网站优化、页面体验\n接口特性：\n- 获取 performance、accessibility、best-practices、seo 四类评分，分值范围 0~100\n- 支持 mobile 与 desktop 两种检测策略，默认 mobile\n- 返回 FCP、LCP、Speed Index、TBT、CLS 等核心页面体验指标\n- 返回标题、描述、可抓取链接、索引可用性、Canonical、HTTP 状态、robots.txt 与 viewport 等 SEO 审计摘要\n- TopIssues 返回最多 10 条主要待优化项，便于快速定位页面优化方向\n- 支持复用近期检测结果，forceRefresh=true 可重新检测并刷新结果\n- 围绕“网页性能与 SEO 评分”提供标准化能力，便于快速接入现有业务\n- 适合将“网页性能与 SEO 评分”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/pagespeed-score",
        "operationId": "get_pagespeed_score",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/pagespeed-score"
        },
        "x-gugudata-api-identity": "pagespeed-score",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": "可通过判断此状态码断言接口正常返回。"
          },
          {
            "code": "501",
            "title": "参数错误",
            "remark": "请检查 URL、strategy、locale、categories 等参数是否正确。"
          },
          {
            "code": "502",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 10 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回请求频率受限；如需更高吞吐，可按需购买额外 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": "接口返回状态码。"
                        },
                        "StatusDescription": {
                          "type": "string",
                          "description": "接口返回状态说明。"
                        },
                        "ResponseDateTime": {
                          "type": "string",
                          "description": "接口数据返回时间。"
                        },
                        "DataTotalCount": {
                          "type": "integer",
                          "format": "int32",
                          "description": "此条件下的总数据量，一般用于分页计算。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "RequestedUrl": {
                          "type": "string",
                          "description": "请求检测的网页 URL。"
                        },
                        "FinalUrl": {
                          "type": "string",
                          "description": "检测完成后的最终网页 URL，可能是重定向后的地址。"
                        },
                        "Strategy": {
                          "type": "string",
                          "description": "本次检测使用的策略，mobile 或 desktop。"
                        },
                        "Locale": {
                          "type": "string",
                          "description": "本次检测使用的语言区域。"
                        },
                        "ReportVersion": {
                          "type": "string",
                          "description": "页面评分报告版本。"
                        },
                        "FetchTime": {
                          "type": "string",
                          "description": "检测报告生成时间。"
                        },
                        "Cached": {
                          "type": "boolean",
                          "description": "本次返回是否来自近期已有检测结果。"
                        },
                        "Scores": {
                          "type": "object",
                          "properties": {
                            "Performance": {
                              "type": "integer",
                              "format": "int32",
                              "description": "性能评分，范围 0~100，没有对应分类时返回 null。"
                            },
                            "Accessibility": {
                              "type": "integer",
                              "format": "int32",
                              "description": "可访问性评分，范围 0~100，没有对应分类时返回 null。"
                            },
                            "BestPractices": {
                              "type": "integer",
                              "format": "int32",
                              "description": "最佳实践评分，范围 0~100，没有对应分类时返回 null。"
                            },
                            "Seo": {
                              "type": "integer",
                              "format": "int32",
                              "description": "SEO 评分，范围 0~100，没有对应分类时返回 null。"
                            }
                          }
                        },
                        "Metrics": {
                          "type": "object",
                          "properties": {
                            "FirstContentfulPaintMs": {
                              "type": "number",
                              "description": "首次内容绘制耗时，单位毫秒。"
                            },
                            "LargestContentfulPaintMs": {
                              "type": "number",
                              "description": "最大内容绘制耗时，单位毫秒。"
                            },
                            "SpeedIndexMs": {
                              "type": "number",
                              "description": "速度指数，单位毫秒。"
                            },
                            "TotalBlockingTimeMs": {
                              "type": "number",
                              "description": "总阻塞时间，单位毫秒。"
                            },
                            "CumulativeLayoutShift": {
                              "type": "number",
                              "description": "累计布局偏移。"
                            }
                          }
                        },
                        "SeoAudits": {
                          "type": "object",
                          "properties": {
                            "Title": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "网页标题 SEO 审计摘要。"
                            },
                            "MetaDescription": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "网页描述 SEO 审计摘要。"
                            },
                            "CrawlableAnchors": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "可抓取链接审计摘要。"
                            },
                            "IsCrawlable": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "索引可用性审计摘要。"
                            },
                            "Canonical": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "Canonical 链接审计摘要。"
                            },
                            "HttpStatusCode": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "网页 HTTP 状态审计摘要。"
                            },
                            "RobotsTxt": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "robots.txt 审计摘要。"
                            },
                            "Viewport": {
                              "type": "object",
                              "additionalProperties": true,
                              "description": "移动端视口配置审计摘要。"
                            }
                          },
                          "description": "网页标题 SEO 审计摘要。"
                        },
                        "TopIssues": {
                          "type": "object",
                          "properties": {
                            "Id": {
                              "type": "string",
                              "description": "主要待优化项 ID。"
                            },
                            "Title": {
                              "type": "string",
                              "description": "主要待优化项标题。"
                            },
                            "Score": {
                              "type": "integer",
                              "format": "int32",
                              "description": "主要待优化项得分，范围 0~100，没有得分时返回 null。"
                            },
                            "DisplayValue": {
                              "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/websitetools/pagespeed-score/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "需要检测评分的网页 URL，必须是有效的 HTTP 或 HTTPS 链接，例如：https://www.baidu.com。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "strategy",
            "in": "query",
            "required": false,
            "description": "检测策略，可选 mobile 或 desktop，默认 mobile。",
            "schema": {
              "type": "string"
            },
            "example": "mobile"
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "description": "返回语言区域，默认 zh-CN。",
            "schema": {
              "type": "string"
            },
            "example": "zh-CN"
          },
          {
            "name": "categories",
            "in": "query",
            "required": false,
            "description": "评分类别，可选 performance、accessibility、best-practices、seo；多个值用英文逗号分隔，不传时返回全部类别。",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "forceRefresh",
            "in": "query",
            "required": false,
            "description": "是否重新检测并刷新结果，默认 false；false 时可优先返回近期已有检测结果。",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ]
      }
    },
    "/websitetools/readability": {
      "post": {
        "summary": "网页可读内容抽取",
        "description": "网页正文智能抽取与结构化\n接口标签：网络工具、文本处理、智能抽取、多种元素信息\n接口特性：\n- 支持从 URL 或 HTML 中抽取网页主体可读内容\n- url 与 html 至少传入一个，传入 html 时可减少外部网页访问的不确定性\n- 返回正文 HTML、纯文本、摘要、标题、站点名和发布时间等字段\n- 适合网页正文抓取、内容清洗、摘要生成前处理和知识库入库等场景\n- 围绕“网页可读内容抽取”提供标准化能力，便于快速接入现有业务\n- 适合将“网页可读内容抽取”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/readability",
        "operationId": "post_readability",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/readability"
        },
        "x-gugudata-api-identity": "readability",
        "x-gugudata-business-status-codes": [
          {
            "code": "200",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "400",
            "title": "参数错误",
            "remark": ""
          },
          {
            "code": "429",
            "title": "请求频率受限",
            "remark": "默认情况下，每个接口提供 5 QPS 并发能力，可满足大多数业务场景。超出当前并发能力时，网关可能返回 429 请求频率受限；如需更高吞吐，可按需购买额外 QPS 扩展包，高频调用场景支持白名单接入与独立流控策略。"
          },
          {
            "code": "403",
            "title": "账号欠费",
            "remark": "请及时关注订单到期短信提醒"
          },
          {
            "code": "402",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "500",
            "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": {
                        "Title": {
                          "type": "string",
                          "description": "网页标题。"
                        },
                        "Byline": {
                          "type": "string",
                          "description": "作者或署名信息。"
                        },
                        "Dir": {
                          "type": "string",
                          "description": "文本方向。"
                        },
                        "Lang": {
                          "type": "string",
                          "description": "网页语言。"
                        },
                        "Content": {
                          "type": "string",
                          "description": "抽取后的正文 HTML。"
                        },
                        "TextContent": {
                          "type": "string",
                          "description": "抽取后的纯文本正文。"
                        },
                        "Length": {
                          "type": "integer",
                          "format": "int32",
                          "description": "纯文本正文长度。"
                        },
                        "Excerpt": {
                          "type": "string",
                          "description": "正文摘要。"
                        },
                        "SiteName": {
                          "type": "string",
                          "description": "站点名称。"
                        },
                        "PublishedTime": {
                          "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/websitetools/readability/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": "待抽取的网页 URL；url 与 html 至少传入一个。"
                  },
                  "html": {
                    "type": "string",
                    "description": "待抽取的 HTML 原文；url 与 html 至少传入一个。"
                  }
                }
              },
              "example": {
                "url": "https://www.gugudata.com",
                "html": ""
              }
            }
          }
        }
      }
    },
    "/websitetools/url2html": {
      "post": {
        "summary": "URL 转静态 HTML 文件",
        "description": "网页 URL 静态化归档\n接口标签：网站工具、HTML、生成静态 HTML 站点、永久存储\n接口特性：\n- 支持将网页 URL 转换为静态 HTML 文件\n- appkey 和 url 通过 JSON 请求体传入\n- 返回生成后的 HTML 文件地址，便于归档、下载、离线阅读或后续处理\n- 转换效果受目标网页访问权限、脚本渲染和访问限制影响\n- 围绕“URL 转静态 HTML 文件”提供标准化能力，便于快速接入现有业务\n- 适合将“URL 转静态 HTML 文件”结果接入业务系统、后台工具和自动化流程\n- 适合合同、票据、课件和归档文件的自动化处理\n- 可与 OCR、PDF 拆分和文档转换接口串联成处理流水线\n详情页：https://www.gugudata.com/api/details/url2html",
        "operationId": "post_url2html",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2html"
        },
        "x-gugudata-api-identity": "url2html",
        "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": "string",
                      "description": "生成后的静态 HTML 文件访问地址。"
                    }
                  },
                  "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/websitetools/url2html/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": "需要转换的网页 URL，需包含 http 或 https 协议。"
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://www.gugudata.com"
              }
            }
          }
        }
      }
    },
    "/websitetools/url2image": {
      "get": {
        "summary": "URL 生成网站截图",
        "description": "高效生成网页截图\n接口标签：网站工具、截图、生成网页截图、图片输出\n接口特性：\n- 支持全页截图和视窗截图\n- 支持自定义截图尺寸\n- 兼容移动设备截图\n- 支持暗黑模式截图\n- 固定参数请求，可以得到最新的站点截图\n- 快速高效的截图生成\n- 围绕“URL 生成网站截图”提供标准化能力，便于快速接入现有业务\n- 适合将“URL 生成网站截图”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/url2image",
        "operationId": "get_url2image",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2image"
        },
        "x-gugudata-api-identity": "url2image",
        "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/websitetools/url2image/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": "YOUR_VALUE"
          },
          {
            "name": "width",
            "in": "query",
            "required": false,
            "description": "输出截图的宽度，默认值为 250",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 250
          },
          {
            "name": "height",
            "in": "query",
            "required": false,
            "description": "输出截图的高度，默认值为 250",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 250
          },
          {
            "name": "viewportWidth",
            "in": "query",
            "required": false,
            "description": "渲染视窗的宽度，默认值为 1080",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1080
          },
          {
            "name": "viewportHeight",
            "in": "query",
            "required": false,
            "description": "渲染视窗的高度，默认值为 1080",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "example": 1080
          },
          {
            "name": "forceReload",
            "in": "query",
            "required": false,
            "description": "强制重新加载缓存的图片，默认值为 false",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "isMobile",
            "in": "query",
            "required": false,
            "description": "是否以移动设备的 User Agent 渲染，默认值为 false",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "isFullPage",
            "in": "query",
            "required": false,
            "description": "是否截取整个页面而非视窗裁剪，默认值为 false",
            "schema": {
              "type": "boolean"
            },
            "example": false
          },
          {
            "name": "isDarkMode",
            "in": "query",
            "required": false,
            "description": "是否优先采用深色模式，默认值为 false",
            "schema": {
              "type": "boolean"
            },
            "example": false
          }
        ]
      }
    },
    "/websitetools/url2json": {
      "post": {
        "summary": "语义化获取站点 JSON 结构内容",
        "description": "网页内容 JSON 提取\n接口标签：语义化提取、JSON、网页解析、AI 智能提取、结构化数据\n接口特性：\n- 基于 AI 大模型智能理解网页内容，按需提取结构化数据\n- 支持自定义 Prompt 指令，灵活指定提取内容和格式\n- 自动解析动态网页，包括 JavaScript 渲染内容\n- 返回标准 JSON 格式，便于程序直接解析使用\n- 适用于商品信息、文章列表、表格数据等多种场景\n- 围绕“语义化获取站点 JSON 结构内容”提供标准化能力，便于快速接入现有业务\n- 适合将“语义化获取站点 JSON 结构内容”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n详情页：https://www.gugudata.com/api/details/url2json",
        "operationId": "post_url2json",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2json"
        },
        "x-gugudata-api-identity": "url2json",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "URL 或 Prompt 参数为空或格式错误"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每秒请求不能超过 20 次"
          },
          {
            "code": "103",
            "title": "账号欠费",
            "remark": ""
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "110",
            "title": "URL JSON 提取失败",
            "remark": "网页无法访问、加载超时或 AI 提取服务异常"
          }
        ],
        "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": "此条件下的总数据量，一般为1"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "additionalProperties": true,
                      "description": "AI 根据 Prompt 从网页提取的结构化 JSON 数据，具体结构取决于 Prompt 指令"
                    }
                  },
                  "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/websitetools/url2json/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": "需要提取数据的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接"
                  },
                  "prompt": {
                    "type": "string",
                    "description": "AI 提取指令，描述需要从网页中提取什么数据，例如：获取所有产品信息、提取文章标题和摘要等"
                  }
                },
                "required": [
                  "url",
                  "prompt"
                ]
              },
              "example": {
                "url": "https://www.example.com",
                "prompt": "获取所有产品信息"
              }
            }
          }
        }
      }
    },
    "/websitetools/url2links": {
      "get": {
        "summary": "网页 URL 链接提取",
        "description": "网页链接资产提取\n接口标签：网站工具、网页处理、网页链接提取、网页解析、链接收集\n接口特性：\n- 支持从网页中提取链接列表\n- url 需传入完整 http 或 https 地址\n- 返回字符串数组，适合网页链接发现、站点巡检、内容采集和 SEO 链接分析等场景\n- 提取结果受页面渲染方式、访问权限和链接写法影响\n- 围绕“网页 URL 链接提取”提供标准化能力，便于快速接入现有业务\n- 适合将“网页 URL 链接提取”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/url2links",
        "operationId": "get_url2links",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2links"
        },
        "x-gugudata-api-identity": "url2links",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "URL 参数为空或格式错误"
          },
          {
            "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": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "网页中提取出的 URL 链接列表。"
                    }
                  },
                  "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/websitetools/url2links/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "需要提取链接的网页 URL，需包含 http 或 https 协议。",
            "schema": {
              "type": "string"
            },
            "example": "https://www.gugudata.com"
          }
        ]
      }
    },
    "/websitetools/url2markdown": {
      "get": {
        "summary": "网页 URL 转 Markdown",
        "description": "网页转 Markdown 文本\n接口标签：网站工具、markdown、网页内容提取、网页解析\n接口特性：\n- 支持任意网页 URL 转换为 Markdown 格式（注意：无法处理具有反爬机制或不合规的网页）\n- 智能提取网页主要内容，过滤无关元素\n- 保持原有文本结构和格式\n- 支持图片、链接等元素的 Markdown 转换\n- 围绕“网页 URL 转 Markdown”提供标准化能力，便于快速接入现有业务\n- 适合将“网页 URL 转 Markdown”结果接入业务系统、后台工具和自动化流程\n- 适合 SEO 分析、竞品研究、内容归档和站点巡检场景\n- 可与网页截图、正文抽取、链接提取和域名检测接口组合\n详情页：https://www.gugudata.com/api/details/url2markdown",
        "operationId": "get_url2markdown",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2markdown"
        },
        "x-gugudata-api-identity": "url2markdown",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "URL 参数为空或格式错误"
          },
          {
            "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": "网页转换后的 Markdown 格式内容"
                    }
                  },
                  "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/websitetools/url2markdown/demo"
        },
        "parameters": [
          {
            "name": "appkey",
            "in": "query",
            "required": true,
            "description": "咕咕数据开发者中心分配的 APPKEY。",
            "schema": {
              "type": "string"
            },
            "example": "{{appkey}}"
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "description": "需要转换的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接",
            "schema": {
              "type": "string"
            },
            "example": "https://www.example.com"
          }
        ]
      }
    },
    "/websitetools/url2snapshot": {
      "post": {
        "summary": "网站截图与 HTML 快照",
        "description": "通过网页 URL 获取站点截图与内容\n接口标签：网站工具、截图、网页截图、网页快照\n接口特性：\n- 支持任意网页 URL 高质量截图，包括动态内容和 JavaScript 渲染页面\n- 支持全页面截图和可视区域截图两种模式\n- 可自定义截图尺寸、设备像素比等参数\n- 支持桌面端和移动端设备模拟\n- 同时返回截图图片和网页文本内容\n- 支持 base64 编码和 CDN URL 两种返回格式\n- 围绕“网站截图与 HTML 快照”提供标准化能力，便于快速接入现有业务\n- 适合将“网站截图与 HTML 快照”结果接入业务系统、后台工具和自动化流程\n详情页：https://www.gugudata.com/api/details/url2snapshot",
        "operationId": "post_url2snapshot",
        "tags": [
          "网站工具接口"
        ],
        "externalDocs": {
          "description": "API detail page",
          "url": "https://www.gugudata.com/api/details/url2snapshot"
        },
        "x-gugudata-api-identity": "url2snapshot",
        "x-gugudata-business-status-codes": [
          {
            "code": "100",
            "title": "正常返回",
            "remark": ""
          },
          {
            "code": "101",
            "title": "参数错误",
            "remark": "URL 参数为空或格式错误"
          },
          {
            "code": "102",
            "title": "请求频率受限",
            "remark": "每秒请求不能超过 50 次"
          },
          {
            "code": "103",
            "title": "账号欠费",
            "remark": ""
          },
          {
            "code": "104",
            "title": "APPKEY 错误",
            "remark": "请检查传递的 APPKEY 是否为开发者中心获取到的值"
          },
          {
            "code": "110",
            "title": "网页截图失败",
            "remark": "网页无法访问、加载超时或截图服务异常"
          },
          {
            "code": "111",
            "title": "图片上传失败",
            "remark": "当responseFormat为url时，图片上传到CDN失败"
          }
        ],
        "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": "此条件下的总数据量，一般为1"
                        },
                        "RequestParameter": {
                          "description": "本次请求的参数摘要。"
                        }
                      },
                      "description": "接口业务状态信息。"
                    },
                    "Data": {
                      "type": "object",
                      "properties": {
                        "Image": {
                          "type": "string",
                          "description": "截图图片，当responseFormat为base64时返回base64编码的图片数据，为url时返回图片链接"
                        },
                        "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/websitetools/url2snapshot/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": "需要截图的网页 URL 地址，必须是有效的 HTTP 或 HTTPS 链接"
                  },
                  "responseFormat": {
                    "type": "string",
                    "description": "返回格式，可选值：base64（返回 base64 编码的图片数据）、url（返回图片 URL 链接）",
                    "enum": [
                      "base64",
                      "url"
                    ]
                  },
                  "fullPage": {
                    "type": "boolean",
                    "description": "是否截取完整页面，true 为全页面截图，false 为可视区域截图"
                  },
                  "width": {
                    "type": "integer",
                    "format": "int32",
                    "description": "截图宽度，单位像素，范围：320-3840"
                  },
                  "height": {
                    "type": "integer",
                    "format": "int32",
                    "description": "截图高度，单位像素，范围：240-2160"
                  },
                  "deviceScaleFactor": {
                    "type": "number",
                    "description": "设备像素比，影响截图清晰度，范围：1-3"
                  },
                  "userAgent": {
                    "type": "string",
                    "description": "用户代理字符串，用于模拟不同的浏览器"
                  },
                  "isMobile": {
                    "type": "boolean",
                    "description": "是否模拟移动设备，true 为移动设备模式，false 为桌面模式"
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://www.example.com",
                "responseFormat": "base64",
                "fullPage": true,
                "width": 1920,
                "height": 1080,
                "deviceScaleFactor": 1,
                "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
                "isMobile": false
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "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": "本次响应数据总数或分页总数。"
          }
        }
      },
      "CommonResponse": {
        "type": "object",
        "description": "咕咕数据标准响应结构。",
        "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": "本次响应数据总数或分页总数。"
              }
            }
          },
          "Data": {
            "description": "接口返回的业务数据。"
          }
        }
      },
      "AdmissionErrorResponse": {
        "type": "object",
        "description": "高校录取预测接口兼容错误响应结构。",
        "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": "本次响应数据总数或分页总数。"
              },
              "Status": {
                "type": "string",
                "description": "稳定机器错误码。"
              },
              "RequestId": {
                "type": "string",
                "description": "用于问题追踪的请求 ID。"
              }
            },
            "required": [
              "StatusCode",
              "Status",
              "StatusDescription",
              "RequestId"
            ]
          },
          "Data": {
            "description": "可选的字段级或业务级错误详情。"
          }
        },
        "required": [
          "DataStatus",
          "Data"
        ]
      }
    },
    "securitySchemes": {
      "AppKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "AppKey",
        "description": "推荐的 AppKey 传递方式。"
      },
      "AppKeyQuery": {
        "type": "apiKey",
        "in": "query",
        "name": "appkey",
        "description": "兼容历史客户端的 Query AppKey。"
      }
    }
  }
}