# Parâmetros de Consulta { #query-parameters }

Quando você declara outros parâmetros na função que não fazem parte dos parâmetros da rota, esses parâmetros são automaticamente interpretados como parâmetros de "consulta".

{* ../../docs_src/query_params/tutorial001_py310.py hl[9] *}

A consulta é o conjunto de pares chave-valor que vai depois de `?` na URL, separado pelo caractere `&`.

Por exemplo, na URL:

```
http://127.0.0.1:8000/items/?skip=0&limit=10

     */
    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`.

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.

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.

Agora é a hora de usá-lo com FastAPI. 🚀

Tínhamos esta anotação de tipo:

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

O que faremos é envolver isso com `Annotated`, para que fique assim:

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

Ambas as versões significam a mesma coisa, `q` é um parâmetro que pode ser `str` ou `None`, e por padrão é `None`.

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.

Ahora es el momento de usarlo con FastAPI. 🚀

Teníamos esta anotación de tipo:

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

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

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

/// check | Inspirou o **FastAPI** a