---

## API Reference

### Search APIs

#### JSON Search API

**Endpoints**:
- `GET /api/v1/documents?q={query}` (recommended)
- `GET /json/?q={query}` (legacy, for backward compatibility)

**Parameters**:
- `q` - Query string
- `num` - Results per page (default: 20)
- `start` - Starting offset (default: 0)
- `fields.label` - Label filter
- `lang` - Language preference

/**
 * Suggestor - jQuery plugin for search autocomplete functionality
 * Provides real-time search suggestions with keyboard and mouse navigation
 */
(function ($) {
  "use strict";

  // Key code constants for better readability
  var KEY_CODES = {
    BACKSPACE: 8,
    ENTER: 13,
    SPACE: 32,
    UP: 38,
    DOWN: 40,
    DELETE: 46,
    NUM_0: 48,
    NUM_9: 57,
    A: 65,
    Z: 90,
    NUMPAD_0: 96,

errors.failed_to_delete_doc_in_admin = Impossibile eliminare il documento.
errors.failed_to_send_testmail=Impossibile inviare l'email di test.
errors.invalid_query_unknown = La query specificata contiene condizioni sconosciute.
errors.invalid_query_parse_error = La query fornita non è valida.
errors.invalid_query_sort_value = L'ordinamento specificato {0} non è valido.

        RenderDataUtil.register(data, "keyMatchItems", keyMatchService.getKeyMatchList(keyMatchPager)); // page navi

        // restore from pager
        copyBeanToBean(keyMatchPager, form, op -> op.include("term", "query"));
    }

    // ===================================================================================
    //                                                                        Edit Execute

        if (crawlingInfo != null) {
            final CrawlingInfoBhv crawlingInfoBhv = ComponentUtil.getComponent(CrawlingInfoBhv.class);
            crawlingInfo = crawlingInfoBhv.selectEntity(cb -> {
                cb.query().docMeta().setId_Equal(getCrawlingInfoId());
            });
        }
        return crawlingInfo;
    }

    public String getKeyMsg() {

     * Default constructor for SearchForm.
     */
    public SearchForm() {
    }

    /**
     * The log type field for filtering search logs.
     */
    public String logType;

    /**
     * The query ID field for searching specific queries.
     */
    public String queryId;

    /**
     * The user session ID field for filtering logs by session.
     */
    public String userSessionId;

    /**

    public Map<String, String[]> fields = new HashMap<>();

    /**
     * Map of advanced search conditions.
     */
    public Map<String, String[]> as = new HashMap<>();

    /**
     * The main search query string.
     */
    @Size(max = 1000)
    public String q;

    /**
     * The sort parameter for search results.
     */
    @Size(max = 1000)
    public String sort;

    /**

		</div>
	</main>
	<jsp:include page="../footer.jsp" />
	<input type="hidden" id="contextPath" value="${pageContext.request.contextPath}" />
	<script type="text/javascript" src="${fe:url('/js/jquery-3.7.1.min.js')}"></script>
	<script type="text/javascript" src="${fe:url('/js/clipboard.min.js')}"></script>
	<script type="text/javascript" src="${fe:url('/js/popper.min.js')}"></script>

<%@page pageEncoding="UTF-8" contentType="text/html; charset=UTF-8"%>
<%-- query did not match any document --%>
<div id="result" class="row">
	<div class="col-md-8">
		<div class="text-center py-4">
			<p class="mb-3"><i class="fa fa-search fa-3x text-muted" aria-hidden="true"></i></p>
			<p class="mb-2"><la:message key="labels.did_not_match" arg0="${displayQuery}" /></p>
			<p class="text-muted"><la:message key="labels.did_not_match_suggestion" /></p>

    public String userFavorite;

    /** The web API JSON setting. */
    public String webApiJson;

    /** The default label value setting. */
    public String defaultLabelValue;

    /** The append query parameter setting. */
    public String appendQueryParameter;

    /** The login required setting. */
    public String loginRequired;

    /** The ignore failure type setting. */
    public String ignoreFailureType;