E seus modelos de banco de dados podem usar qualquer outro nome que você desejar.

Mas para a*path operation* (operação decaminho) de login, precisamos usar esses nomes para serem compatíveis com a especificação (e poder, por exemplo, usar o sistema integrado de documentação da API).

Mas para a*operação derota* de login, precisamos usar esses nomes para serem compatíveis com a especificação (e poder, por exemplo, usar o sistema integrado de documentação da API).

A especificação também afirma que o`username` e a`password` devem ser enviados como dados de formulário (portanto, não há JSON aqui).

Cada “scope” é apenas uma string (sem espaços).

Normalmente são usados​​para declarar permissões de segurança específicas, por exemplo:

Normalmente são usados para declarar permissões de segurança específicas, por exemplo:

*`users:read` ou`users:write` são exemplos comuns.

*`instagram_basic` é usado pelo Facebook e Instagram.

*`https://www.googleapis.com/auth/drive` é usado pelo Google.

/// info |"Informação"

/// info | Informação

No OAuth2, um "scope" é apenas uma string que declara uma permissão específica necessária.

Primeiro, importe`OAuth2PasswordRequestForm` e use-o como uma dependência com`Depends` na*path operation* (operação decaminho) para`/token`:

Primeiro, importe`OAuth2PasswordRequestForm` e use-o como uma dependência com`Depends` na*operação derota* para`/token`:

//// tab | Python 3.10+

//// tab | Python 3.10+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

//// tab | Python 3.8+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

* Um campo`scope` opcional como uma string grande, composta de strings separadas por espaços.

* Um`grant_type` (tipo de concessão) opcional.

/// tip |"Dica"

/// tip | Dica

A especificação OAuth2 na verdade*requer* um campo`grant_type` com um valor fixo de`password`, mas`OAuth2PasswordRequestForm` não o impõe.

* Um`client_id` opcional (não precisamos dele em nosso exemplo).

* Um`client_secret` opcional (não precisamos dele em nosso exemplo).

/// info |"Informação"

/// info | Informação

O`OAuth2PasswordRequestForm` não é uma classe especial para**FastAPI** como é`OAuth2PasswordBearer`.

/// tip |"Dica"

/// tip | Dica

A instância da classe de dependência`OAuth2PasswordRequestForm` não terá um atributo`scope` com a string longa separada por espaços, em vez disso, terá um atributo`scopes` com a lista real de strings para cada escopo enviado.

//// tab | Python 3.10+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

//// tab | Python 3.8+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

//// tab | Python 3.8+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

`UserInDB(**user_dict)` means:

`UserInDB(**user_dict)` significa:

*Passe as keys (chaves) e values (valores) de`user_dict` diretamente como argumentos de valor-chave, equivalente a:*

Para este exemplo simples, seremos completamente inseguros e retornaremos o mesmo`username` do token.

/// tip |"Dica"

/// tip | Dica

No próximo capítulo, você verá uma implementação realmente segura, com hash de senha e tokens <abbrtitle="JSON Web Tokens">JWT</abbr>.

//// tab | Python 3.10+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

//// tab | Python 3.8+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

////

/// tip |"Dica"

/// tip | Dica

Pela especificação, você deve retornar um JSON com um`access_token` e um`token_type`, o mesmo que neste exemplo.

//// tab | Python 3.10+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

//// tab | Python 3.8+ non-Annotated

/// tip |"Dica"

/// tip | Dica

Prefira usar a versão`Annotated`, se possível.

////

/// info |"Informação"

/// info | Informação

O cabeçalho adicional`WWW-Authenticate` com valor`Bearer` que estamos retornando aqui também faz parte da especificação.