POST管理接口
后台手动新增反馈
后台补录渠道外收集到的反馈。与客户端提交端点不同：不做重复抑制，也不写入 ip / user_agent / 地理位置等来源字段（这些只在真实客户端上报时才有意义）。
URL
/api/v1/admin/projects/{projectKey}/feedbacks鉴权方式
需要管理员 JWT 或 API Key，二者等价（Authorization: Bearer <token>）
请求参数
Path 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| projectKey | string | 是 | 项目主键 project_key（大小写不敏感） |
Header 参数
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | Bearer <管理员 JWT 或 API Key> |
请求体
{
"user_id": "user-001",
"rating": 5,
"content": "更新检查很好用。",
"contact": "[email protected]",
"forward_to_github": false,
"platform": "windows",
"platform_version": "11",
"custom_data": {
"app_version": "1.2.0"
}
}响应示例
201 创建成功
{
"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
}POST
