Fess 15.10の開発版に、検索結果と内容がほぼ同じ別URLの文書を調べるAPIが入りました。開発版の検索結果で取得した文書IDを使い、たとえば GET /api/v2/documents/a1b2c3/similar?num=5 を呼びます。テーマでリンクを出すには、テーマ側でこのAPIを呼び出す処理を追加します。
件数と空の結果を読み分ける
照合には既存の内容署名 content_minhash_bits を使います。署名が同じ候補をURL順で返し、元の文書と同じURLは除きます。内容を編集して署名が変わった文書や、話題だけが近い文書は対象外です。元の文書が見えない場合は404、内容や語がない場合や検索エンジンにCodeLibsプラグインがない場合は200で空の配列です。追加の再インデックスは不要です。
元文書と候補にロール、仮想ホスト、追加クエリの絞り込みがかかり、ログイン必須の設定も適用されます。検索APIと同じ方法でアクセストークンを使えます。 num の初期値は10、上限は20と paging.search.page.max.size の小さい方で、取得できるのは1ページです。呼び出し制限 api.search.similar.rate.limit.per.minute は初期値30、0で解除できます。429の場合は Retry-After に従います。