{
  "version": "1.0.0",
  "name": "上海芮生建设工程有限公司 API 鉴权文档",
  "description": "说明如何安全地访问网站API",
  "authentication": {
    "type": "none",
    "status": "public",
    "description": "当前所有API端点均为公开访问，无需鉴权"
  },
  "oauth2": {
    "supported": true,
    "authorization_endpoint": "https://www.shrsfsgc.com/oauth/authorize",
    "token_endpoint": "https://www.shrsfsgc.com/oauth/token",
    "registration_endpoint": "https://www.shrsfsgc.com/oauth/register",
    "userinfo_endpoint": "https://www.shrsfsgc.com/oauth/userinfo",
    "jwks_uri": "https://www.shrsfsgc.com/.well-known/jwks.json",
    "scopes_supported": ["openid", "profile", "email", "offline_access"],
    "response_types_supported": ["code", "token", "id_token", "code token", "code id_token", "token id_token", "code token id_token"],
    "grant_types_supported": ["authorization_code", "implicit", "refresh_token", "client_credentials"],
    "code_challenge_methods_supported": ["plain", "S256"]
  },
  "endpoints": [
    {"path": "/api/index.json", "method": "GET", "auth": "none", "description": "API端点索引"},
    {"path": "/api/company.json", "method": "GET", "auth": "none", "description": "公司基本信息"},
    {"path": "/api/services.json", "method": "GET", "auth": "none", "description": "服务项目列表"},
    {"path": "/api/cases.json", "method": "GET", "auth": "none", "description": "工程案例列表"},
    {"path": "/api/faq.json", "method": "GET", "auth": "none", "description": "常见问题列表"},
    {"path": "/api/news.json", "method": "GET", "auth": "none", "description": "新闻列表"},
    {"path": "/api/knowledge.json", "method": "GET", "auth": "none", "description": "知识文章列表"},
    {"path": "/api/qualifications.json", "method": "GET", "auth": "none", "description": "资质荣誉列表"},
    {"path": "/api/equipment.json", "method": "GET", "auth": "none", "description": "施工设备列表"},
    {"path": "/api/partners.json", "method": "GET", "auth": "none", "description": "合作伙伴列表"},
    {"path": "/api/pricing.json", "method": "GET", "auth": "none", "description": "收费标准"},
    {"path": "/api/contact.json", "method": "GET", "auth": "none", "description": "联系信息"},
    {"path": "/api/pages.json", "method": "GET", "auth": "none", "description": "页面列表"},
    {"path": "/api/seo.json", "method": "GET", "auth": "none", "description": "SEO元数据"},
    {"path": "/api/sitemap.json", "method": "GET", "auth": "none", "description": "站点地图索引"},
    {"path": "/api/llms.json", "method": "GET", "auth": "none", "description": "LLMs配置"},
    {"path": "/api/agent.json", "method": "GET", "auth": "none", "description": "Agent配置"},
    {"path": "/api/oauth.json", "method": "GET", "auth": "none", "description": "OAuth配置"},
    {"path": "/api/jwks.json", "method": "GET", "auth": "none", "description": "JWKS公钥集"},
    {"path": "/api/openapi.json", "method": "GET", "auth": "none", "description": "OpenAPI规范"}
  ],
  "security_best_practices": [
    "使用HTTPS协议访问所有API端点",
    "遵循速率限制，避免频繁请求",
    "使用标准的OAuth 2.0流程获取访问令牌",
    "妥善保管API密钥和访问令牌",
    "定期轮换访问令牌"
  ],
  "cors": {
    "enabled": true,
    "allowed_origins": ["*"],
    "allowed_methods": ["GET", "OPTIONS"],
    "allowed_headers": ["Content-Type", "Authorization"]
  },
  "error_codes": [
    {"code": 400, "description": "请求参数错误"},
    {"code": 401, "description": "未授权，需要有效的访问令牌"},
    {"code": 403, "description": "禁止访问，权限不足"},
    {"code": 404, "description": "资源不存在"},
    {"code": 429, "description": "请求过于频繁，超出速率限制"},
    {"code": 500, "description": "服务器内部错误"}
  ],
  "contact": {
    "email": "service@shrsfsgc.com",
    "phone": "17317627656",
    "wechat": "hua768329262",
    "website": "https://www.shrsfsgc.com"
  },
  "metadata": {
    "generated_at": "2026-08-05T00:00:00Z",
    "version": "1.0"
  }
}