{"openapi":"3.0.3","info":{"title":"云评网 API","description":"云服务商信誉评价平台公开 API — 查询厂商信息、用户评价、评分和统计数据。共收录 194 家国内外云服务商，涵盖综合云、VPS、CDN、数据库、AI云、存储、安全、容器云、通信云、边缘计算等 11 个分类。","version":"2.0.0","contact":{"email":"cludecode@foxmail.com","name":"云评网"},"license":{"name":"CC BY-NC-SA 4.0","url":"https://creativecommons.org/licenses/by-nc-sa/4.0/"}},"servers":[{"url":"https://itreshub.com","description":"生产环境"}],"tags":[{"name":"AI","description":"AI 专用接口（精简格式，无需认证）"},{"name":"通用","description":"通用查询接口"}],"paths":{"/api/ai/providers":{"get":{"tags":["AI"],"summary":"获取厂商列表（AI 精简版）","description":"返回所有收录的云服务商列表，适合 AI 系统快速消费。支持按分类筛选。","parameters":[{"name":"category","in":"query","description":"分类筛选（综合云/VPS/CDN/数据库/AI云/存储/安全云/容器云/通信云/边缘计算/计算）","schema":{"type":"string"}},{"name":"limit","in":"query","description":"返回数量上限（默认200，最大500）","schema":{"type":"integer","default":200}}],"responses":{"200":{"description":"厂商列表","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"providers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string"},"avg_rating":{"type":"number"},"review_count":{"type":"integer"},"url":{"type":"string"}}}}}}}}}}}},"/api/ai/search":{"get":{"tags":["AI"],"summary":"搜索厂商","description":"按关键词搜索云服务商，匹配厂商名称、描述和分类。","parameters":[{"name":"q","in":"query","required":true,"description":"搜索关键词","schema":{"type":"string"}}],"responses":{"200":{"description":"搜索结果"}}}},"/api/ai/provider/{slug}":{"get":{"tags":["AI"],"summary":"获取厂商详情","description":"获取单个厂商的完整信息，包括评分分布和最近评价。","parameters":[{"name":"slug","in":"path","required":true,"description":"厂商 slug（如 aliyun、tencent-cloud）","schema":{"type":"string"}}],"responses":{"200":{"description":"厂商详情"},"404":{"description":"厂商不存在"}}}},"/api/ai/reviews":{"get":{"tags":["AI"],"summary":"获取厂商评价列表","description":"返回指定厂商的所有已审核用户评价。","parameters":[{"name":"slug","in":"query","required":true,"description":"厂商 slug","schema":{"type":"string"}},{"name":"limit","in":"query","description":"返回数量上限（默认50，最大100）","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"评价列表"},"404":{"description":"厂商不存在"}}}},"/api/ai/site-info":{"get":{"tags":["AI"],"summary":"获取平台统计信息","description":"返回平台收录厂商数、评价数、用户数、分类列表等统计数据。","responses":{"200":{"description":"站点信息"}}}},"/api/ai/export":{"get":{"tags":["AI"],"summary":"全量数据导出（推荐 AI/搜索引擎使用）","description":"一次请求获取所有厂商+评分+分类+统计数据，适合 AI 系统做本地索引。支持 JSON（默认）和 CSV（?format=csv）格式。","parameters":[{"name":"format","in":"query","description":"导出格式：json（默认）或 csv","schema":{"type":"string","default":"json"}}],"responses":{"200":{"description":"全量数据（JSON 或 CSV）"}}}},"/api/ai/context":{"get":{"tags":["AI"],"summary":"AI 上下文块（可直接注入 LLM prompt）","description":"返回预格式化的 Markdown 上下文块，包含平台简介、热门厂商列表、API 用法。AI Agent 可直接注入 system prompt。支持 ?topic= 参数聚焦特定主题。","parameters":[{"name":"topic","in":"query","description":"聚焦主题（如 VPS、数据库、CDN）","schema":{"type":"string"}}],"responses":{"200":{"description":"Markdown 格式的上下文块","content":{"text/plain":{}}}}}},"/api/ai/smart-search":{"post":{"tags":["AI"],"summary":"自然语言智能搜索（推荐）","description":"接受自然语言查询（如「便宜好用的VPS」「国产数据库」），自动解析意图（类别/特征/品牌/区域），按相关度排序返回厂商列表。每个结果附带 match_reasons（匹配原因）。","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","description":"自然语言搜索词"}}}}}},"responses":{"200":{"description":"搜索结果（含意图理解和匹配原因）","content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"understood":{"type":"object","description":"AI 解析的意图（categories/features/brands/keywords）"},"total":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"slug":{"type":"string"},"category":{"type":"string"},"avg_rating":{"type":"number"},"review_count":{"type":"integer"},"match_reasons":{"type":"array","items":{"type":"string"}},"relevance_score":{"type":"number"},"url":{"type":"string"}}}}}}}}}}}},"/api/ai/suggest":{"get":{"tags":["AI"],"summary":"搜索建议/自动补全","description":"返回搜索建议（厂商名、分类、品牌别名、热门词），用于前端自动补全。","parameters":[{"name":"q","in":"query","required":true,"description":"输入文本","schema":{"type":"string"}}],"responses":{"200":{"description":"建议列表"}}}},"/api/ai/trending":{"get":{"tags":["AI"],"summary":"热门搜索词","description":"返回热门搜索词（基于搜索日志+人工精选）。","responses":{"200":{"description":"热门搜索列表"}}}},"/api/ai/related/{slug}":{"get":{"tags":["AI"],"summary":"相关厂商推荐","description":"返回指定厂商的同类相关厂商推荐。","parameters":[{"name":"slug","in":"path","required":true,"description":"厂商 slug","schema":{"type":"string"}}],"responses":{"200":{"description":"相关厂商列表"}}}},"/api/ai/compare-nl":{"get":{"tags":["AI"],"summary":"自然语言厂商对比","description":"解析「A vs B」格式，返回对比厂商详细信息+智能摘要。","parameters":[{"name":"q","in":"query","required":true,"description":"对比查询（如「阿里云vs腾讯云」）","schema":{"type":"string"}}],"responses":{"200":{"description":"对比结果"}}}},"/api/providers":{"get":{"tags":["通用"],"summary":"获取厂商列表（完整版）","description":"返回厂商列表，支持分页、搜索、分类筛选和排序。注意返回结构是 { items: [...] }。","parameters":[{"name":"page","in":"query","schema":{"type":"integer","default":1}},{"name":"limit","in":"query","schema":{"type":"integer","default":12}},{"name":"search","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string","default":"created_at"}},{"name":"order","in":"query","schema":{"type":"string","default":"desc"}}],"responses":{"200":{"description":"厂商列表（分页）"}}}},"/api/stats":{"get":{"tags":["通用"],"summary":"获取平台统计数据","description":"返回平台统计数据。注意数据嵌套在 stats 字段中：{ stats: { providers, reviews, users, ... }, categories: [...] }","responses":{"200":{"description":"统计数据"}}}},"/api/homepage":{"get":{"tags":["通用"],"summary":"获取首页聚合数据","description":"一次请求返回首页所有动态数据：热门厂商、最新评价、分类Top。","responses":{"200":{"description":"首页数据"}}}}}}