{* ../../docs_src/dependencies/tutorial005_an_py310.py hl[8:9] *}

Esse código declara um parâmetro de consulta opcional, `q`, com o tipo `str`, e então retorna esse parâmetro.

Isso é bastante simples (e não muito útil), mas irá nos ajudar a focar em como as subdependências funcionam.

## Segunda dependência, "dependable" e "dependente" { #second-dependency-dependable-and-dependant }

significa todos os endereços IP disponíveis; dessa forma, ficará acessível publicamente para qualquer pessoa que consiga se comunicar com a máquina. É assim que você normalmente o executaria em produção, por exemplo, em um contêiner.

Na maioria dos casos, você teria (e deveria ter) um "proxy de terminação" tratando o HTTPS por cima; isso dependerá de como você faz o deploy da sua aplicação, seu provedor pode fazer isso por você ou talvez seja necessário que você configure isso por conta...

En la mayoría de los casos tendrías (y deberías) tener un "proxy de terminación" manejando HTTPS por ti, esto dependerá de cómo despliegues tu aplicación, tu proveedor podría hacer esto por ti, o podrías necesitar configurarlo tú mismo.

/// tip | Consejo

El orden de cada diccionario de metadata de etiqueta también define el orden mostrado en la interfaz de documentación.

Por ejemplo, aunque `users` iría después de `items` en orden alfabético, se muestra antes porque agregamos su metadata como el primer diccionario en la list.

## URL de OpenAPI { #openapi-url }

Por defecto, el esquema OpenAPI se sirve en `/openapi.json`.

Pero puedes configurarlo con el parámetro `openapi_url`.

* `externalDocs`: um `dict` descrevendo a documentação externa com:
    * `description`: uma `str` com uma breve descrição da documentação externa.
    * `url` (**obrigatório**): uma `str` com a URL da documentação externa.

### Criar Metadados para tags { #create-metadata-for-tags }

Vamos tentar isso em um exemplo com tags para `users` e `items`.

Crie metadados para suas tags e passe-os para o parâmetro `openapi_tags`:

        },
        "brazilian_stop": {
          "type":       "stop",

        },
        "brazilian_stop": {
          "type":       "stop",

    // Windows reserved names
    private static final Set<String> WINDOWS_RESERVED = Set.of("CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6",
            "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", "LPT9");

    // Configuration
    private final int maxPathLength;
    private final int maxComponentLength;

labels.search_list_button_delete=Excluir
labels.search_list_delete_confirmation=Tem certeza de que deseja excluí-lo?
labels.search_list_button_delete_all=Excluir tudo com esta consulta
labels.search_list_delete_all_confirmation=Tem certeza de que deseja excluir tudo com esta consulta?
labels.search_list_button_cancel=Cancelar
labels.failure_url_configuration=URL de falha
labels.failure_url_search_url=URL

labels.index_help=Ayuda
labels.search_options=Opciones de búsqueda
labels.search_options_close=Cerrar
labels.search_options_clear=Limpiar
labels.search_cache_msg=Esta es una caché de {0}. Es una instantánea de la página tal como apareció en {1}.
labels.search_unknown=Desconocido
labels.footer_back_to_top=Volver arriba
labels.header_brand_name=Fess
labels.header_form_option_btn=Opciones
labels.file_crawling_configuration=Rastreo de archivos