GET管理接口

查询反馈评分分布

范围内该项目的评分直方图与平均分。档位固定 1..5,缺档也会返回 0。未打分的反馈计入 unrated,不并入任何档位:混进 1 星会让平均分变成谎话,丢掉又会让 total 对不上反馈列表条数。

URL

/api/v1/admin/projects/{projectKey}/stats/feedbacks

鉴权方式

需要管理员 JWT 或 API Key,二者等价(Authorization: Bearer <token>)

请求参数

Path 参数

名称类型必填说明
projectKeystring项目主键 project_key(大小写不敏感)

Query 参数

名称类型必填说明
start_timeintegerUnix 时间戳(秒)
end_timeintegerUnix 时间戳(秒)

Header 参数

名称类型必填说明
AuthorizationstringBearer <管理员 JWT 或 API Key>

该接口无需请求体。

响应示例

200 反馈评分分布

{
  "start_time": 1760000000,
  "end_time": 1762000000,
  "total": 96,
  "unrated": 12,
  "average_rating": 4.3,
  "by_rating": [
    {
      "rating": 1,
      "count": 3
    },
    {
      "rating": 2,
      "count": 5
    },
    {
      "rating": 3,
      "count": 9
    },
    {
      "rating": 4,
      "count": 22
    },
    {
      "rating": 5,
      "count": 45
    }
  ]
}
GET

Try It Out

请求 URL 预览

/api/v1/admin/projects/verhub/stats/feedbacks?start_time=1760000000&end_time=1762000000