검색 기록 API

이 문서에서는 Fess 의 v2 검색 기록 API 에 대해 설명합니다. 공통 응답 엔벨로프·오류 모델에 대해서는 API 개요 를 참조하십시오.

베이스 URL은 http://<Server Name>/api/v2/ 입니다 (로컬 환경 예: http://localhost:8080/api/v2 ).

참고

검색 기록은 search.history.enabled (기본값: true )와 검색 로그 기록이 모두 활성화된 경우에 사용할 수 있습니다. /api/v2/ui/config 의 features.search_history 로 상태를 확인할 수 있습니다.

최근 검색 가져오기

요청

HTTP 메서드	GET
엔드포인트	`/api/v2/search-history`

로그인한 사용자가 현재 가상 호스트에서 /api/v2/search 로 수행한 최근 검색을 최신순으로 반환합니다. 반환된 조건으로 같은 검색을 다시 실행할 수 있습니다.

첫 페이지의 검색만 대상입니다. 같은 조건의 검색은 가장 최근의 1건으로 합쳐집니다. 검색어가 없는 검색은 포함되지 않습니다.
반환하는 건수는 최대 search.history.size (기본값: 10 )건입니다.
검색 로그는 1분마다 실행되는 작업으로 기록되므로, 검색이 기록에 나타나기까지 최대 1분 정도 걸립니다.
기록은 세션의 로그인 사용자에 연결됩니다. 익명 호출자는 auth_required (401)가 되며, 액세스 토큰은 로그인을 대신하지 않습니다.
검색 기록 기능이 비활성화된 경우 invalid_request (400)가 됩니다.

요청 파라미터는 없습니다.

응답

성공 시(200)에는 공통 엔벨로프의 response 바로 아래에 다음 필드가 반환됩니다.

{
  "response": {
    "status": 0,
    "record_count": 1,
    "data": [
      {
        "q": "fess",
        "fields": { "label": ["docs"] },
        "sort": "last_modified.desc",
        "requested_at": "2026-10-01T09:00:00Z",
        "hit_count": 42
      }
    ]
  }
}

응답 필드
`record_count`	`data` 안의 검색 건수(int).
`data`	최근 검색의 배열(최신순). 조건의 키는 `/api/v2/search` 의 요청 파라미터 이름이며, 그 검색에서 사용하지 않은 키는 생략됩니다.
`data[].q`	검색어(str).
`data[].fields`	`fields.<name>` 으로 지정한 필드 조건(필드 이름을 키로 하는 값의 배열).
`data[].ex_q`	추가 쿼리(str 배열).
`data[].sort`	정렬 순서(str).
`data[].lang`	`lang` 으로 지정한 언어(str 배열).
`data[].requested_at`	검색한 일시(UTC, ISO-8601).
`data[].hit_count`	그 검색의 히트 수(int64).

표: 응답 필드

오류 응답

오류 응답
상태 코드	설명
400 Bad Request	검색 기록 기능이 비활성화된 경우.
401 Unauthorized	로그인하지 않은 경우.
405 Method Not Allowed	HTTP 메서드가 허용되지 않는 경우.
500 Internal Server Error	서버 내부 오류가 발생한 경우.

표: 오류 응답

기본 제공 테마에서의 표시

기본 제공 bootstrap 테마에서는 로그인한 사용자가 빈 검색 상자를 클릭하거나 검색 상자에서 아래쪽 화살표 키를 누르면 추천 드롭다운에 최근 검색이 표시됩니다. 항목을 선택하면 라벨 등의 조건을 포함해 같은 검색을 실행합니다. Fess 15.9 이전에 기록된 검색 로그에는 조건이 저장되어 있지 않으므로 기록에 표시되지 않습니다.