*
     * @param <T1>
     *            The type of the first value
     * @param <T2>
     *            The type of the second value
     * @param <T3>
     *            The type of the third value
     * @param <T4>
     *            The type of the fourth value
     * @param <T5>
     *            The type of the fifth value
     * @param value1
     *            The first value

    }

    /**
     * Attaches an artifact to the project with an explicitly specified type.
     *
     * @param session the current build session
     * @param project the project to attach the artifact to
     * @param type the type of the artifact (e.g., "jar", "war", "sources")
     * @param path the path to the artifact file
     * @see org.apache.maven.api.Type
     */
    default void attachArtifact(

Veamos cómo hacer uso de una subclase personalizada de `Request` para descomprimir requests gzip.

Y una subclase de `APIRoute` para usar esa clase de request personalizada.

### Crear una clase personalizada `GzipRequest`

/// tip | Consejo

        return getContentsAsStream(contents, null);
    }

    /**
     * Retrieves the XML content as an {@link InputStream} with the specified encoding.
     *
     * @param contents
     *            The content. Must not be {@literal null}.
     * @param encoding
     *            The encoding. If {@literal null}, the platform's default encoding will be used.
     * @return {@link InputStream}
     */

    }

    /**
     * Prompts the user for a string using a list of possible values and a default reply.
     *
     * @param message the message to display
     * @param possibleValues the list of possible values
     * @param defaultReply the default reply value
     * @return the string entered by the user
     * @throws PrompterException if an exception occurs
     */
    @Nonnull

Luego descubrí que había un estándar para documentar APIs, usando JSON (o YAML, una extensión de JSON) llamado Swagger.

Y ya existía una interfaz de usuario web para las APIs Swagger. Por lo tanto, ser capaz de generar documentación Swagger para una API permitiría usar esta interfaz de usuario web automáticamente.

En algún punto, Swagger fue entregado a la Linux Foundation, para ser renombrado OpenAPI.

     *
     * @param <T1>
     *            The type of the first value
     * @param <T2>
     *            The type of the second value
     * @param <T3>
     *            The type of the third value
     * @param value1
     *            The first value
     * @param value2
     *            The second value
     * @param value3
     *            The third value

	* O frontend armazena aquele token temporariamente em algum lugar.
	* O usuário clica no frontend para ir à outra seção daquele frontend do aplicativo web.
	* O frontend precisa buscar mais dados daquela API.
		* Mas precisa de autenticação para aquele endpoint em específico.

     *            The pattern string.
     * @return The converted {@link Date}.
     */
    public static Date toDate(final Object src, final String pattern) {
        return toDate(src, pattern, LocaleUtil.getDefault());
    }

    /**
     * Converts the given object to a {@link Date}.
     *
     * @param src
     *            The source object to convert.
     * @param locale

     *            The pattern string.
     * @return The converted {@link Date}.
     */
    public static Date toDate(final Object src, final String pattern) {
        return toDate(src, pattern, LocaleUtil.getDefault());
    }

    /**
     * Converts the given object to a {@link Date}.
     *
     * @param src
     *            The source object to convert.
     * @param locale