メニュー

サジェストAPI

サジェストワード一覧の取得

Fess に、 http://<Server Name>/api/v1/suggest-words?q=サジェストワード のリクエストを送ることで、Fess に登録されているサジェストワードの一覧をJSON形式で受け取ることができます。 サジェストワードAPIを利用するには、管理画面のシステム 全般の設定でドキュメントでサジェスト、検索語でサジェストを有効にしておく必要があります。

リクエストパラメーター

使用できるリクエストパラメーターは以下の通りです。

リクエストパラメーター
q サジェストを行うキーワード。 (例) q=fess
num サジェストされる単語の数。デフォルト10。 (例) num=20
label フィルタされたラベル名。 (例) fields=java,python
fields サジェスト対象を絞り込むフィールド名。デフォルト絞り込みなし。 (例) fields=content,title
lang 検索言語の指定。 (例) lang=en

レスポンス

以下のようなレスポンスが返ります。

{
  "query_time": 18,
  "record_count": 355,
  "page_size": 10,
  "data": [
    {
      "text": "fess",
      "labels": [
        "java",
        "python"
      ]
    }
  ]
}

各要素については以下の通りです。

レスポンス情報
query_time クエリ処理時間。
record_count サジェストワードのの登録件数。
data 検索結果の親要素。
text サジェストワード。
labels ラベルの値。