点击日志 API

本文档介绍 Fess v2 点击日志 API。 公共响应信封、错误模型及 CSRF 相关内容，请参阅 API 概述。

基础 URL 为 http://<Server Name>/api/v2/（本地环境示例：http://localhost:8080/api/v2）。

记录点击

请求

HTTP 方法	POST
端点	/api/v2/click

将搜索结果的点击记录到搜索日志。 对于匿名调用方，以及搜索日志功能已禁用的安装环境，会返回成功响应并附带 logged: false（不报错）。

由于是修改状态的请求，需要携带 X-Fess-CSRF-Token 头（参见 API 概述）。

请求体

以 Content-Type: application/json 发送包含以下字段的 JSON（ClickRequest）。

{
  "doc_id": "a1b2c3d4e5f6",
  "query_id": "f8b1c2d3e4a5",
  "rank": 1,
  "rt": 1717142400000
}

请求体

doc_id	文档 ID（str，必填，格式 ^[A-Za-z0-9_-]+$）。
query_id	搜索 API 返回的 query_id（str）。
rank	结果列表中从 1 开始的位置（int，>=1）。
rt	原始搜索请求的 epoch 毫秒（int64）。未指定时，服务器当前时间为默认值。

表: 请求体

响应

成功时（200），以下字段会在公共信封的 response 下直接返回。

{
  "response": {
    "status": 0,
    "ok": true,
    "logged": true
  }
}

各字段说明如下。

响应字段

ok	始终为 true（bool）。
logged	当搜索日志持久化已禁用或调用方为匿名时为 false（bool）。即使如此，也会返回 200 响应。

表: 响应字段

错误响应

错误模型详情请参阅 API 概述。该端点返回的 HTTP 状态码如下。

错误响应

状态码	说明
400 Bad Request	请求不合法时。
403 Forbidden	因 CSRF 令牌缺失或过期等原因被拒绝时。
404 Not Found	找不到资源时。
405 Method Not Allowed	不允许使用该 HTTP 方法时。
413 Payload Too Large	请求体超过大小限制时。
415 Unsupported Media Type	不支持的 Content-Type 时。
500 Internal Server Error	发生服务器内部错误时。

表: 错误响应