GET管理接口
查询反馈列表
按项目分页查询反馈，支持关键字搜索与平台、评分筛选。默认不返回已隐藏的反馈， `include_hidden=true` 时一并返回。
URL
/api/v1/admin/projects/{projectKey}/feedbacks鉴权方式
需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Query 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | 分页大小 |
| offset | integer | 否 | 分页偏移 |
| include_hidden | boolean | 否 | 是否连已隐藏的反馈一起返回。 |
| search | string | 否 | 关键字，不区分大小写地匹配 content、user_id、contact、ip、city、country_name、 region_name 与 platform_version；custom_data 为 JSON 列，不参与匹配。 |
| platform | windows | linux | macos | ios | android | web | others | 否 | 按平台筛选列表内容（不是客户端平台声明，与请求统计无关）。 对版本与公告这类有发布范围的资源，未限定平台的记录对任何平台都可见。 |
| rating | integer | 否 | 只看该评分的反馈；未评分的反馈不会命中任何评分值。 |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
该接口无需请求体。
响应示例
200 响应
{
"total": 1,
"data": [
{
"id": "fb-001",
"user_id": "user-001",
"rating": 5,
"content": "更新检查很好用。",
"contact": "[email protected]",
"is_hidden": false,
"platform": "windows",
"platform_version": "11",
"custom_data": {
"app_version": "1.2.0"
},
"ip": "203.0.113.9",
"user_agent": "verhub-sdk/1.0",
"country_code": "CN",
"country_name": "中国",
"region_name": "广东省",
"city": "深圳",
"created_at": 1760000000
}
]
}GET
