API des requêtes et contenus associés

Cette page décrit les deux points de terminaison permettant de récupérer des informations associées à une requête.

  • GET /related-queries — Récupère les suggestions de requêtes associées à une requête.

  • GET /related-content — Récupère le contenu HTML associé à une requête.

Pour l’enveloppe de réponse commune et le modèle d’erreur, voir Vue d’ensemble de l’API.

Récupération des requêtes associées

Requête

Méthode HTTP GET
Point de terminaison /api/v2/related-queries

En envoyant une requête à Fess de type http://<Server Name>/api/v2/related-queries?q=fess, vous pouvez recevoir au format JSON la liste des requêtes associées à la requête spécifiée.

Même si q est vide ou non spécifié, aucune erreur n’est retournée : un tableau queries vide est renvoyé. La réponse est toujours une enveloppe de succès.

Paramètres de requête

Paramètres de requête
q Terme de recherche pour lequel récupérer les requêtes associées. (Ex.) q=fess

Réponse

En cas de succès, une réponse au format d’enveloppe commune est retournée.

{
  "response": {
    "status": 0,
    "queries": [
      "fess search",
      "fess install"
    ]
  }
}

Les détails de chaque élément de response sont les suivants.

Informations de réponse
queries Tableau des requêtes associées (tableau de chaînes de caractères). Tableau vide si q est vide ou non spécifié.

Réponse d’erreur

Réponses d’erreur
Code de statut Description
405 Method Not Allowed Une méthode HTTP non prise en charge a été spécifiée.
500 Internal Server Error Une erreur interne s’est produite sur le serveur.

Récupération du contenu associé

Requête

Méthode HTTP GET
Point de terminaison /api/v2/related-content

En envoyant une requête à Fess de type http://<Server Name>/api/v2/related-content?q=fess, vous pouvez recevoir au format JSON le contenu HTML associé à la requête spécifiée.

Si plusieurs éléments de contenu correspondent, ils sont concaténés avec des sauts de ligne. Même si q est vide ou non spécifié, aucune erreur n’est retournée : un content vide (chaîne vide) est renvoyé. La réponse est toujours une enveloppe de succès.

Paramètres de requête

Paramètres de requête
q Terme de recherche pour lequel récupérer le contenu associé. (Ex.) q=fess

Réponse

En cas de succès, une réponse au format d’enveloppe commune est retournée.

{
  "response": {
    "status": 0,
    "content": "<div>...contenu HTML associé...</div>",
    "content_type": "html"
  }
}

Les détails de chaque élément de response sont les suivants.

Informations de réponse
content Contenu HTML associé (chaîne de caractères). Si plusieurs éléments correspondent, ils sont concaténés avec des sauts de ligne. Chaîne vide si q est vide ou non spécifié.
content_type Type de contenu. La valeur est toujours html.

Réponse d’erreur

Réponses d’erreur
Code de statut Description
405 Method Not Allowed Une méthode HTTP non prise en charge a été spécifiée.
500 Internal Server Error Une erreur interne s’est produite sur le serveur.