反馈接口参考
反馈 Agent 查询
供外部 Agents 轮询未处理反馈数量的只读接口。
- 路由
- /api/feedbacks/agent/summary
- 方法
- GET
- 认证头
- x-feedback-agent-token
只读汇总，不暴露反馈内容
这个接口只给外部 Agent 轮询统计使用。响应不会包含反馈正文、联系方式、日志、附件或单条记录 ID。
总览
只读汇总路由
Agent 只能读取聚合统计，不返回反馈正文、联系方式、日志或附件信息。
GET /api/feedbacks/agent/summary 用于定期查询当前反馈处理概况。
接口使用独立 FEEDBACK_AGENT_TOKEN，不复用反馈客户端上报令牌或管理员会话 Cookie。
- 响应包含 all、unprocessed、processing、processed、hasUnprocessed 和 generatedAt。
- 外部 Agent 可用 unprocessed 或 hasUnprocessed 判断是否需要提醒人工处理。
- 该接口不支持筛选、分页或读取单条反馈详情。
GET
Agent 查询反馈汇总
供外部 Agents 定期查询当前未处理反馈数量。
GET/api/feedbacks/agent/summary
鉴权
需要校验 x-feedback-agent-token 与 FEEDBACK_AGENT_TOKEN。
请求
无请求体；请求头必须携带 x-feedback-agent-token。
请求示例bash
curl -sS "https://hupingzhi.cn/api/feedbacks/agent/summary" \
-H "x-feedback-agent-token: $FEEDBACK_AGENT_TOKEN"响应
响应字段
返回反馈聚合统计和生成时间，不返回任何单条反馈内容。
HTTP 200json
{
"unprocessed": 3,
"processed": 9,
"all": 12,
"hasUnprocessed": true,
"generatedAt": "2026-06-29T10:00:00.000Z"
}| Name | Type | Required | Description | Notes |
|---|---|---|---|---|
| unprocessed | number | Required | 当前未处理反馈数量。 | - |
| hasUnprocessed | boolean | Required | 是否存在未处理反馈，可直接用于 Agent 判断是否提醒。 | - |
| processed | number | Required | 当前已处理反馈数量。 | - |
| all | number | Required | 反馈总数。 | - |
| generatedAt | string | Required | 服务端生成汇总的 ISO 时间。 | - |
状态码
错误和状态码
Agent 只需要区分成功、未授权和服务端错误。