{
  "openapi": "3.0.0",
  "info": {
    "title": "上海芮生建设工程有限公司 API",
    "description": "上海芮生建设工程有限公司官方网站信息接口，提供结构化JSON数据供AI Agent和第三方系统使用",
    "version": "1.0.0",
    "contact": {
      "name": "芮生防水",
      "url": "https://www.shrsfsgc.com",
      "email": "service@shrsfsgc.com"
    },
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    }
  },
  "servers": [
    {
      "url": "https://www.shrsfsgc.com",
      "description": "官方网站"
    }
  ],
  "paths": {
    "/api/index.json": {
      "get": {
        "summary": "API端点索引",
        "description": "获取所有可用的API端点列表",
        "operationId": "getApiIndex",
        "tags": ["API元数据"],
        "responses": {
          "200": {
            "description": "API端点索引",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "endpoints": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "path": { "type": "string" },
                          "description": { "type": "string" }
                        }
                      }
                    },
                    "metadata": {
                      "type": "object",
                      "properties": {
                        "total": { "type": "integer" },
                        "generated_at": { "type": "string", "format": "date-time" },
                        "version": { "type": "string" }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/company.json": {
      "get": {
        "summary": "公司基本信息",
        "description": "获取公司基本信息，包括名称、简介、联系方式、服务范围",
        "operationId": "getCompanyInfo",
        "tags": ["公司信息"],
        "responses": {
          "200": {
            "description": "公司基本信息",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "company": {
                      "type": "object",
                      "properties": {
                        "name": { "type": "string" },
                        "description": { "type": "string" },
                        "phone": { "type": "string" },
                        "email": { "type": "string" },
                        "address": { "type": "string" },
                        "services": {
                          "type": "array",
                          "items": { "type": "string" }
                        }
                      }
                    },
                    "metadata": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/services.json": {
      "get": {
        "summary": "服务项目列表",
        "description": "获取6大核心服务详细信息，包括名称、描述、特点",
        "operationId": "getServices",
        "tags": ["服务"],
        "responses": {
          "200": {
            "description": "服务项目列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "services": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "name": { "type": "string" },
                          "description": { "type": "string" },
                          "features": {
                            "type": "array",
                            "items": { "type": "string" }
                          },
                          "route": { "type": "string" }
                        }
                      }
                    },
                    "metadata": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/cases.json": {
      "get": {
        "summary": "工程案例列表",
        "description": "获取工程案例列表，包括标题、类型、摘要、材料",
        "operationId": "getCases",
        "tags": ["案例"],
        "responses": {
          "200": {
            "description": "工程案例列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "cases": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string" },
                          "title": { "type": "string" },
                          "type": { "type": "string" },
                          "summary": { "type": "string" },
                          "materials": {
                            "type": "array",
                            "items": { "type": "string" }
                          }
                        }
                      }
                    },
                    "metadata": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/faq.json": {
      "get": {
        "summary": "常见问题列表",
        "description": "获取常见问题列表，包含问答对",
        "operationId": "getFAQ",
        "tags": ["知识"],
        "responses": {
          "200": {
            "description": "常见问题列表",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "faqs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "question": { "type": "string" },
                          "answer": { "type": "string" }
                        }
                      }
                    },
                    "metadata": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/": {
      "get": {
        "summary": "首页",
        "description": "公司首页，展示核心服务、案例、资质等信息",
        "operationId": "getHomepage",
        "tags": ["页面"],
        "responses": {
          "200": {
            "description": "首页内容",
            "content": {
              "text/html": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/service-items.html": {
      "get": {
        "summary": "服务项目列表",
        "description": "查看所有防水服务项目",
        "operationId": "getServiceItems",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "服务项目列表" }
        }
      }
    },
    "/roof-waterproof.html": {
      "get": {
        "summary": "屋顶防水保温",
        "description": "专业屋顶防水保温系统，有效解决屋顶渗漏和隔热问题",
        "operationId": "getRoofWaterproof",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "屋顶防水服务详情" }
        }
      }
    },
    "/basement-waterproof.html": {
      "get": {
        "summary": "地下室防水防潮",
        "description": "地下室专业防水防潮解决方案，保持地下室干燥舒适",
        "operationId": "getBasementWaterproof",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "地下室防水服务详情" }
        }
      }
    },
    "/wall-waterproof.html": {
      "get": {
        "summary": "外墙防水翻新",
        "description": "外墙防水修复和翻新服务，解决外墙渗水脱落问题",
        "operationId": "getWallWaterproof",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "外墙防水服务详情" }
        }
      }
    },
    "/villa-waterproof.html": {
      "get": {
        "summary": "别墅防水保温",
        "description": "别墅整体防水保温系统，高端定制化防水解决方案",
        "operationId": "getVillaWaterproof",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "别墅防水服务详情" }
        }
      }
    },
    "/tile-renovation.html": {
      "get": {
        "summary": "斜瓦防水翻新",
        "description": "斜屋顶瓦片防水修复，专业解决瓦片屋面渗漏",
        "operationId": "getTileRenovation",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "斜瓦防水服务详情" }
        }
      }
    },
    "/commercial-renovation.html": {
      "get": {
        "summary": "工程防水修缮",
        "description": "大型工程防水修缮服务，商业建筑专业防水解决方案",
        "operationId": "getCommercialRenovation",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "工程防水服务详情" }
        }
      }
    },
    "/cases.html": {
      "get": {
        "summary": "工程案例",
        "description": "真实工程案例展示，包含施工前后对比",
        "operationId": "getCasesPage",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "工程案例列表" }
        }
      }
    },
    "/construction-cases.html": {
      "get": {
        "summary": "施工案例",
        "description": "施工过程案例展示",
        "operationId": "getConstructionCases",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "施工案例列表" }
        }
      }
    },
    "/pricing.html": {
      "get": {
        "summary": "收费标准",
        "description": "透明报价，无隐形消费",
        "operationId": "getPricing",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "收费标准详情" }
        }
      }
    },
    "/baike.html": {
      "get": {
        "summary": "防水百科",
        "description": "专业防水知识科普大全",
        "operationId": "getBaike",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "防水百科内容" }
        }
      }
    },
    "/knowledge.html": {
      "get": {
        "summary": "防水知识",
        "description": "实用的防水技巧和知识",
        "operationId": "getKnowledge",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "防水知识内容" }
        }
      }
    },
    "/faq.html": {
      "get": {
        "summary": "常见问题",
        "description": "防水常见问题解答",
        "operationId": "getFAQPage",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "常见问题解答" }
        }
      }
    },
    "/news.html": {
      "get": {
        "summary": "新闻资讯",
        "description": "防水行业动态与公司最新资讯",
        "operationId": "getNews",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "新闻资讯列表" }
        }
      }
    },
    "/about.html": {
      "get": {
        "summary": "关于我们",
        "description": "公司介绍、资质荣誉、团队实力",
        "operationId": "getAbout",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "公司介绍" }
        }
      }
    },
    "/contact.html": {
      "get": {
        "summary": "联系我们",
        "description": "联系方式、在线留言、服务区域",
        "operationId": "getContact",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "联系方式" }
        }
      }
    },
    "/qualifications.html": {
      "get": {
        "summary": "资质荣誉",
        "description": "行业认证、获奖证书、合作伙伴",
        "operationId": "getQualifications",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "资质荣誉" }
        }
      }
    },
    "/equipment.html": {
      "get": {
        "summary": "施工设备",
        "description": "专业施工设备展示",
        "operationId": "getEquipment",
        "tags": ["页面"],
        "responses": {
          "200": { "description": "施工设备" }
        }
      }
    },
    "/api-docs.html": {
      "get": {
        "summary": "API鉴权文档",
        "description": "API访问指南、安全最佳实践、OAuth 2.0配置说明",
        "operationId": "getApiDocs",
        "tags": ["开发者资源"],
        "responses": {
          "200": { "description": "API鉴权文档" }
        }
      }
    }
  },
  "tags": [
    { "name": "API元数据", "description": "API端点索引和元数据" },
    { "name": "公司信息", "description": "公司基本信息" },
    { "name": "服务", "description": "防水服务相关" },
    { "name": "案例", "description": "工程案例展示" },
    { "name": "知识", "description": "防水知识科普" },
    { "name": "页面", "description": "网站主要页面" },
    { "name": "开发者资源", "description": "API文档和开发者工具" }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "authorizationCode": {
            "authorizationUrl": "/oauth/authorize",
            "tokenUrl": "/oauth/token",
            "scopes": {
              "openid": "OpenID Connect基础权限",
              "profile": "获取用户基本信息",
              "email": "获取用户邮箱地址",
              "offline_access": "获取刷新令牌"
            }
          }
        }
      }
    }
  },
  "security": [
    { "oauth2": [] }
  ]
}