API des clics

Ce document décrit l’API des journaux de clics v2 de Fess. Pour l’enveloppe de réponse commune, le modèle d’erreur et les jetons CSRF, voir Vue d’ensemble de l’API.

L’URL de base est http://<Server Name>/api/v2/ (exemple en environnement local : http://localhost:8080/api/v2).

Enregistrement d’un clic

Requête

Méthode HTTP	POST
Point de terminaison	/api/v2/click

Enregistre un clic sur un résultat de recherche dans le journal de recherche. Pour les appelants anonymes et les installations où la fonctionnalité de journal de recherche est désactivée, la réponse de succès retourne logged: false (aucune erreur n’est générée).

Cette requête modifiant l’état, l’en-tête X-Fess-CSRF-Token est requis (voir Vue d’ensemble de l’API).

Corps de la requête

Envoyez un JSON (ClickRequest) avec Content-Type: application/json contenant les champs suivants.

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

Corps de la requête

doc_id	Identifiant du document (str, obligatoire, motif ^[A-Za-z0-9_-]+$).
query_id	query_id retourné par l’API de recherche (str).
rank	Position dans la liste de résultats, à base 1 (int, >=1).
rt	Epoch en millisecondes de la requête de recherche d’origine (int64). Si non spécifié, l’heure courante du serveur est utilisée par défaut.

Tableau : Corps de la requête

Réponse

En cas de succès (200), les champs suivants sont retournés directement sous response dans l’enveloppe commune.

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

Les détails de chaque champ sont les suivants.

Champs de réponse

ok	Toujours true (bool).
logged	Vaut false si la persistance du journal de recherche est désactivée ou si l’appelant est anonyme (bool). Une réponse 200 est malgré tout retournée dans ce cas.

Tableau : Champs de réponse

Réponse d’erreur

Pour le détail du modèle d’erreur, voir Vue d’ensemble de l’API. Les statuts HTTP retournés par ce point de terminaison sont les suivants.

Réponses d’erreur

Code de statut	Description
400 Bad Request	La requête est incorrecte.
403 Forbidden	Non autorisé (jeton CSRF manquant ou expiré, etc.).
404 Not Found	Ressource introuvable.
405 Method Not Allowed	La méthode HTTP n’est pas autorisée.
413 Payload Too Large	Le corps de la requête dépasse la limite de taille.
415 Unsupported Media Type	Content-Type non pris en charge.
500 Internal Server Error	Une erreur interne s’est produite sur le serveur.

Tableau : Réponses d’erreur