///

You can declare additional responses, with additional status codes, media types, descriptions, etc.

Those additional responses will be included in the OpenAPI schema, so they will also appear in the API docs.

But for those additional responses you have to make sure you return a `Response` like `JSONResponse` directly, with your status code and content.

## Additional Response with `model` { #additional-response-with-model }

            NtStatus.NT_STATUS_SHARING_VIOLATION, NtStatus.NT_STATUS_INVALID_PARAMETER })
    @DisplayName("Should handle various NT status codes")
    void testVariousNTStatusCodes(int ntStatus) {
        // When
        SmbException exception = new SmbException(ntStatus, false);

        // Then
        assertNotNull(exception);

	// Source contains the line number, function and file name of the code
	// on the client node that requested the lock.
	Source string `msgp:"omitempty"`

	// Quorum represents the expected quorum for this lock type.
	Quorum *int `msgp:"omitempty"`
}

// ResponseCode is the response code for a locking request.
type ResponseCode uint8

// Response codes for a locking request.
const (
	RespOK ResponseCode = iota

    }

    @Test
    @DisplayName("Unknown DOS error code yields empty Optional")
    void testUnknownCode() {
        Optional<Integer> noMatch = findNtStatus(0xdeadbeef);
        assertFalse(noMatch.isPresent(), "Mapping for unknown code should be absent");
    }

    @Test
    @DisplayName("Mocked consumer receives correct NTSTATUS value")

        assertEquals(0x1, Smb2IoctlRequest.SMB2_O_IOCTL_IS_FSCTL);
    }

    @Test
    @DisplayName("Test configuration with different control codes")
    void testDifferentControlCodes() {
        setupMockConfig();
        // Test with different control codes
        int[] controlCodes = { Smb2IoctlRequest.FSCTL_PIPE_PEEK, Smb2IoctlRequest.FSCTL_PIPE_WAIT, Smb2IoctlRequest.FSCTL_PIPE_TRANSCEIVE,

///

## Schreiben des Codes, der den Callback dokumentiert { #write-the-callback-documentation-code }

Dieser Code wird nicht in Ihrer Anwendung ausgeführt, wir benötigen ihn nur, um zu *dokumentieren*, wie diese *externe API* aussehen soll.

        // Act & Assert
        SmbException thrown = assertThrows(SmbException.class, () -> {
            new LsaPolicyHandle(mockDcerpcHandle, server, access);
        });

        // In smb1, non-NTSTATUS error codes get mapped to NT_STATUS_UNSUCCESSFUL (0xC0000001)
        assertEquals(0xC0000001, thrown.getNtStatus()); // NT_STATUS_UNSUCCESSFUL
        verify(mockDcerpcHandle, times(1)).sendrecv(any(MsrpcLsarOpenPolicy2.class));
    }

The status codes in the 400 range mean that there was an error from the client.

Remember all those **"404 Not Found"** errors (and jokes)?

## Use `HTTPException` { #use-httpexception }

To return HTTP responses with errors to the client you use `HTTPException`.

### Import `HTTPException` { #import-httpexception }

            requirements**.txt
            pyproject.toml
      - name: Install Dependencies
        run: uv pip install -r requirements-github-actions.txt -r requirements-translations.txt
      - name: Export Language Codes
        id: show-langs
        run: |
          echo "langs=$(python ./scripts/translate.py llm-translatable-json)" >> $GITHUB_OUTPUT
          echo "commands=$(python ./scripts/translate.py commands-json)" >> $GITHUB_OUTPUT

                // Unknown code → hex string (uppercase)
                Arguments.of(0xDEADBEEF, "0xDEADBEEF"));
    }

    @ParameterizedTest
    @MethodSource("errorCodes")
    void constructorInitialisesMessageAndStatus(int code, String expectedMsg) {
        SmbAuthException e = new SmbAuthException(code);
        assertEquals(expectedMsg, e.getMessage(), "message for code " + Integer.toHexString(code));