面向开发者的 API 技术文档
本页只列出当前已实现并可供外部 GET 的分析 API 与数据集。当存储的来源数据不可用时，可选字段可能省略。
提供状态
以下端点不需要 API 密钥。目前不提供专属付费方案、带宽保证或历史趋势 API。请避免频繁轮询，并正确处理 404、503 和缺失字段。数据集包含最新 100 条记录，采用 CC BY-NC 4.0。
指标含义
unusualReviewSignal（数据集保留旧字段名 fraudScore）是 0–100 的异常发帖倾向信号。它不是欺诈评论所占比例，也不能证明欺诈或评分操纵。reliabilityScore 是单独存储的复合评论指标，并非 100 − unusualReviewSignal。
公开端点
以下数值仅用于说明响应结构。不可用的可选字段不会返回。
GET
/api/v1/game/[appId]返回已保存的分析等级、可用指标、六轴评分和游戏信息。不提供历史序列，historyStatus 为 unavailable。没有分析时返回 404。
请求参数
appIdstring必填（路径）仅含数字的 Steam App ID响应示例（JSON）
{
"appId": "730",
"gameName": "Counter-Strike 2",
"status": "completed",
"analyzedAt": "2026-06-03T00:00:00.000Z",
"summary": "Retrieved-review sample analysis...",
"metrics": {
"aiRating": "S",
"reliabilityLevel": "High",
"reliabilityScore": 88,
"unusualReviewSignal": 12,
"scoreGap": 1
},
"scoreBreakdown": {
"graphics": 90,
"gameplay": 95,
"story": 70,
"value": 85,
"volume": 90,
"stability": 92
},
"gameInfo": {
"developers": ["Valve"],
"publishers": ["Valve"],
"genres": ["Action", "Free to Play"],
"hasJapanese": true
},
"historyStatus": "unavailable"
}GET
/api/check/[appId]返回已有分析的简要展示数据。此 GET 请求不会启动新分析。没有分析时返回 404。
请求参数
appIdstring必填（路径）仅含数字的 Steam App ID响应示例（JSON）
{
"title": "Counter-Strike 2",
"score": "S",
"unusualReviewSignal": 12,
"hasHighUnusualReviewSignal": false,
"summary": "Retrieved-review sample analysis...",
"historyStatus": "unavailable",
"headerImageUrl": "https://shared.akamai.steamstatic.com/..."
}GET
/api/dataset/download以 CSV 返回最新 100 条公开摘要，并在响应头中包含许可证。
响应格式
CSV text (CC BY-NC 4.0)GET
/api/dataset/download-json以 JSON 数组返回最新 100 条公开摘要。缺失指标为 null。
响应示例（JSON）
[
{
"appId": "730",
"gameName": "Counter-Strike 2",
"platform": "STEAM",
"analyzedAt": "2026-06-03T00:00:00.000Z",
"scoreJp": 88,
"scoreEn": 89,
"scoreGap": 1,
"aiRating": "S",
"fraudScore": 12
}
]