API de registro de clics

Este documento describe la API de registro de clics v2 de Fess. Para el sobre de respuesta común, el modelo de errores y CSRF, consulte Descripción general de la API.

La URL base es http://<Server Name>/api/v2/ (ejemplo en entorno local: http://localhost:8080/api/v2).

Registro de un clic

Solicitud

Método HTTP	POST
Endpoint	/api/v2/click

Registra el clic en un resultado de búsqueda en el registro de búsqueda. Para llamadas anónimas y en instalaciones donde la función de registro de búsqueda está deshabilitada, se devuelve una respuesta de éxito con logged: false (sin error).

Al ser una solicitud que modifica el estado, se requiere la cabecera X-Fess-CSRF-Token (consulte Descripción general de la API).

Cuerpo de la solicitud

Envíe un JSON (ClickRequest) con Content-Type: application/json con los siguientes campos:

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

Cuerpo de la solicitud

doc_id	ID del documento (str, obligatorio, patrón ^[A-Za-z0-9_-]+$).
query_id	query_id devuelto por la API de búsqueda (str).
rank	Posición en la lista de resultados desde 1 (int, >=1).
rt	Epoch en milisegundos de la solicitud de búsqueda original (int64). Cuando no se especifica, se usa la hora actual del servidor como valor predeterminado.

Tabla: Cuerpo de la solicitud

Respuesta

En caso de éxito (200), se devuelven los siguientes campos directamente bajo response del sobre común.

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

Los campos son los siguientes:

Campos de respuesta

ok	Siempre true (bool).
logged	false cuando la persistencia del registro de búsqueda está deshabilitada o el llamante es anónimo (bool). Aun así se devuelve una respuesta 200.

Tabla: Campos de respuesta

Respuesta de error

Consulte Descripción general de la API para detalles del modelo de errores. Los estados HTTP que devuelve este endpoint son:

Respuesta de error

Código de estado	Descripción
400 Bad Request	Cuando la solicitud no es válida.
403 Forbidden	Cuando no está permitido por ausencia o expiración del token CSRF, entre otros motivos.
404 Not Found	Cuando no se encuentra el recurso.
405 Method Not Allowed	Cuando el método HTTP no está permitido.
413 Payload Too Large	Cuando el cuerpo de la solicitud supera el límite de tamaño.
415 Unsupported Media Type	Cuando el Content-Type no es admitido.
500 Internal Server Error	Cuando se produce un error interno del servidor.

Tabla: Respuesta de error