protected boolean httpOnly = true;

    /**
     * Retrieves the user code for the current request.
     * The user code is used to uniquely identify users across sessions and requests.
     * It checks multiple sources in order: request attribute, request parameter, cookie, user bean, or generates a new one.
     *
     * @return the user code string, or null if no valid session exists
     */
    public String getUserCode() {

                .put(getApiPath() + "/upload");

        int statusCode = response.getStatusCode();
        // Accept either 200 (success) or other status codes based on implementation
        assertTrue(statusCode == 200 || statusCode == 400, "Status code should be 200 or 400, but was " + statusCode);

        if (statusCode == 200) {
            JsonPath jsonPath = JsonPath.from(response.asString());

        assertTrue(exception.getStackTrace().length > 0);
    }

    @Test
    public void test_differentMessageCodes() {
        // Setup - test with different message codes
        final String message = "Test message";
        final VaMessenger<FessMessages> loginErrorCode = messages -> messages.addErrorsSsoLoginError(UserMessages.GLOBAL_PROPERTY_KEY);

        super.tearDown(testInfo);
    }

    // Test basic initialization
    @Test
    public void test_hookInitialization() {
        assertNotNull(apiFailureHook);
    }

    // Test API result status codes
    @Test
    public void test_apiResultStatusCodes() {
        // Test OK status
        ApiResult okResult = new ApiResult.ApiResponse().status(Status.OK).result();
        assertNotNull(okResult);

        int logoutHashCode = SsoResponseType.LOGOUT.hashCode();

        // Hash code should be consistent for the same object
        assertEquals(metadataHashCode, SsoResponseType.METADATA.hashCode());
        assertEquals(logoutHashCode, SsoResponseType.LOGOUT.hashCode());

        // Different enum constants should have different hash codes (usually)
        assertNotSame(metadataHashCode, logoutHashCode);
    }

    @Test

    /** Configuration key for crawler clients used in parameter maps */
    protected static final String CRAWLER_CLIENTS = "crawlerClients";

    /** HTTP status code for Not Found */
    private static final int HTTP_STATUS_NOT_FOUND = 404;

    /** HTTP status code for OK */
    private static final int HTTP_STATUS_OK = 200;

    /**
     * Cache for client rules mapping client names to their corresponding URL patterns.

        int[] codes = (int[]) propMap.get(CRAWLER_FAILURE_URL_STATUS_CODES);
        if (codes == null) {
            codes = split(getCrawlerFailureUrlStatusCodes(), ",")
                    .get(stream -> stream.filter(StringUtil::isNotBlank).mapToInt(Integer::parseInt).toArray());
            propMap.put(CRAWLER_FAILURE_URL_STATUS_CODES, codes);
        }

    }

    @Test
    public void test_formatCode() {
        String code;
        String value;

        code = "";
        value = FessFunctions.formatCode("L", "prettyprint", "text/plain", code);
        assertEquals("<pre class=\"prettyprint\"></pre>", value);

        code = "aaa";
        value = FessFunctions.formatCode("L", "prettyprint", "text/plain", code);
        assertEquals("<pre class=\"prettyprint\">aaa</pre>", value);

 * This exception includes an HTTP status code to indicate the nature of the error.
 */
public class WebApiException extends FessSystemException {

    private static final long serialVersionUID = 1L;

    /**
     * The HTTP status code associated with this exception.
     */
    private final int statusCode;

    /**
     * Gets the HTTP status code associated with this exception.
     *

    /** Error code for request timeout. */
    public static final String ERROR_TIMEOUT = "timeout";

    /** Error code for context length exceeded. */
    public static final String ERROR_CONTEXT_LENGTH_EXCEEDED = "context_length_exceeded";

    /** Error code for model not found. */
    public static final String ERROR_MODEL_NOT_FOUND = "model_not_found";

    /** Error code for invalid response from the LLM provider. */