API de Log

Vision General

La API de Log es para obtener informacion de registros de Fess. Puede consultar registros de busqueda, registros de clics, registros del sistema, etc.

URL Base

/api/admin/log

Lista de Endpoints

Metodo Ruta Descripcion
GET /search Obtener registros de busqueda
GET /click Obtener registros de clics
GET /favorite Obtener registros de favoritos
DELETE /search/delete Eliminar registros de busqueda

Obtener Registros de Busqueda

Solicitud

GET /api/admin/log/search

Parametros

Respuesta

{
  "response": {
    "status": 0,
    "logs": [
      {
        "id": "log_id_1",
        "queryId": "query_id_1",
        "query": "fess search",
        "requestedAt": "2025-01-29T10:30:00Z",
        "responseTime": 123,
        "hitCount": 567,
        "user": "guest",
        "roles": ["guest"],
        "languages": ["ja"],
        "clientIp": "192.168.1.100",
        "userAgent": "Mozilla/5.0..."
      }
    ],
    "total": 1234
  }
}

Obtener Registros de Clics

Solicitud

GET /api/admin/log/click

Parametros

Ademas de los mismos parametros que los registros de busqueda, se pueden especificar los siguientes:

Respuesta

{
  "response": {
    "status": 0,
    "logs": [
      {
        "id": "click_log_id_1",
        "queryId": "query_id_1",
        "url": "https://example.com/doc1",
        "docId": "doc_id_1",
        "order": 1,
        "clickedAt": "2025-01-29T10:31:00Z",
        "user": "guest",
        "clientIp": "192.168.1.100"
      }
    ],
    "total": 567
  }
}

Obtener Registros de Favoritos

Solicitud

GET /api/admin/log/favorite

Parametros

Los mismos parametros que los registros de clics.

Respuesta

{
  "response": {
    "status": 0,
    "logs": [
      {
        "id": "favorite_log_id_1",
        "url": "https://example.com/doc1",
        "docId": "doc_id_1",
        "createdAt": "2025-01-29T10:32:00Z",
        "user": "user123"
      }
    ],
    "total": 123
  }
}

Eliminar Registros de Busqueda

Solicitud

DELETE /api/admin/log/search/delete

Parametros

Respuesta

{
  "response": {
    "status": 0,
    "deletedCount": 5678
  }
}

Ejemplos de Uso

Obtener Registros de Busqueda Recientes

curl -X GET "http://localhost:8080/api/admin/log/search?size=50&page=0" \
     -H "Authorization: Bearer YOUR_TOKEN"

Registros de Busqueda de un Periodo Especifico

curl -X GET "http://localhost:8080/api/admin/log/search?from=2025-01-01&to=2025-01-31" \
     -H "Authorization: Bearer YOUR_TOKEN"

Registros de Busqueda de una Consulta Especifica

curl -X GET "http://localhost:8080/api/admin/log/search?query=fess" \
     -H "Authorization: Bearer YOUR_TOKEN"

Obtener Registros de Clics

curl -X GET "http://localhost:8080/api/admin/log/click?size=100" \
     -H "Authorization: Bearer YOUR_TOKEN"

Eliminar Registros de Busqueda Antiguos

# Eliminar registros anteriores a 30 dias
curl -X DELETE "http://localhost:8080/api/admin/log/search/delete?before=2024-12-30T00:00:00Z" \
     -H "Authorization: Bearer YOUR_TOKEN"

Informacion de Referencia