*/
    NetbiosAddress getNbtByName(String host, int type, String scope) throws UnknownHostException;

    /**
     * Determines the address of a host given it's host name. The name can be a NetBIOS name like
     * "freto" or an IP address like "192.168.1.15". It cannot be a DNS name;
     * the analygous {@link jcifs.netbios.UniAddress} or {@link java.net.InetAddress}
     * <code>getByName</code> methods can be used for that.
     *

Essa parte do Nome do Domínio se dá muito antes do HTTPS, mas como tudo depende do domínio e endereço IP público, vale a pena mencioná-la aqui.

///

### DNS { #dns }

Agora vamos focar em todas as partes que realmente fazem parte do HTTPS.

Primeiro, o navegador iria verificar com os servidores DNS qual o IP do domínio, nesse caso, `someapp.example.com`.

Así que, lo que haremos a continuación es agregar el código para documentar cómo debería verse esa *API externa* para recibir el callback de *tu API*.

O módulo `items` terá uma variável `router` (`items.router`). Esta é a mesma que criamos no arquivo `app/routers/items.py`, é um objeto `APIRouter`.

E então fazemos o mesmo para o módulo `users`.

Também poderíamos importá-los como:

```Python
from app.routers import items, users
```

/// info | Informação

A primeira versão é uma "importação relativa":

O **FastAPI** fornece várias ferramentas, em diferentes níveis de abstração, para implementar essas funcionalidades de segurança.

Neste exemplo, vamos usar **OAuth2**, com o fluxo **Password**, usando um token **Bearer**. Fazemos isso usando a classe `OAuth2PasswordBearer`.

/// info | Informação

Um token "bearer" não é a única opção.

Mas é a melhor para o nosso caso de uso.

Você também pode, é claro, passar vários `examples`:

{* ../../docs_src/schema_extra_example/tutorial004_an_py310.py hl[23:38] *}

Quando fizer isso, os exemplos farão parte do **JSON Schema** interno para esses dados do body.

AY6Q,IAAuBjR,SAASgR,OAGtEzQ,OAAA,WACM7F,EAAAA,QAAEgM,IAAsBZ,SAASlJ,SAASqT,IAC5C7T,KAAKwW,QAELxW,KAAKmX,UAMThB,WAAA,SAAW1J,EAAMyK,GAAW,IAAAjS,EAAAjF,KAC1B,QAD0B,IAAXkX,IAAAA,EAAO,KAClB5Y,EAAAA,QAAEmO,GAAMjM,SA9GU,cA8GtB,CAIA,IAAM4W,EAAa,GACbC,EAAU/Y,EAAAA,QAAEmO,GAAMmC,QAAQ7N,KAAhB,eACVuW,EAAchZ,EAAAA,QAAEmO,GAAMmC,QAAQ7N,KAAhB,mBAEd4M,EAAO0J,EAAQ7O,KAAK,QACpBmO,EAAOU,EAAQtW,KAAK,KAAK8C,WAAWlC,SAAS4V,MAAMhW,OAMzD,GAJA6V,EAAWT,KAAO3W,KAAKwX,UAAUb,GACjCS,EAAWzJ,KAAOA,EAClByJ,EAAWF,KAAOA,EAES,IAAvBI...

{* ../../docs_src/response_model/tutorial001_01_py310.py hl[16,21] *}

O FastAPI usará este tipo de retorno para:

* **Validar** os dados retornados.

Teníamos esta anotación de tipo:

//// tab | Python 3.10+

```Python
q: str | None = None
```

////

//// tab | Python 3.9+

```Python
q: Union[str, None] = None
```

////

Lo que haremos es envolver eso con `Annotated`, para que se convierta en:

//// tab | Python 3.10+

```Python
q: Annotated[str | None] = None
```

////

//// tab | Python 3.9+

```Python

/// check | **FastAPI** inspirado para