{"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/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":"首页数据"}}}}}}