E então o novo OpenAPI 3.1.0 passou a se basear na versão mais recente (JSON Schema 2020-12), que incluiu esse novo campo `examples`.

Y entonces el nuevo OpenAPI 3.1.0 se basó en la última versión (JSON Schema 2020-12) que incluía este nuevo campo `examples`.

Y ahora este nuevo campo `examples` tiene precedencia sobre el viejo campo único (y personalizado) `example`, que ahora está obsoleto.

### `scope` { #scope }

A especificação também diz que o cliente pode enviar outro campo de formulário "`scope`".

O nome do campo do formulário é `scope` (no singular), mas na verdade é uma longa string com "escopos" separados por espaços.

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

### `scope` { #scope }

La especificación también indica que el cliente puede enviar otro campo del formulario llamado "`scope`".

El nombre del campo del formulario es `scope` (en singular), pero en realidad es un string largo con "scopes" separados por espacios.

Cada "scope" es simplemente un string (sin espacios).

### Anotações de tipo e ferramentas { #type-annotations-and-tooling }

Primeiro, vamos ver como editores, mypy e outras ferramentas veriam isso.

`BaseUser` tem os campos base. Então `UserIn` herda de `BaseUser` e adiciona o campo `password`, então, ele incluirá todos os campos de ambos os modelos.

Anotamos o tipo de retorno da função como `BaseUser`, mas na verdade estamos retornando uma instância `UserIn`.

### Anotaciones de Tipos y Herramientas { #type-annotations-and-tooling }

Primero vamos a ver cómo los editores, mypy y otras herramientas verían esto.

`BaseUser` tiene los campos base. Luego `UserIn` hereda de `BaseUser` y añade el campo `password`, por lo que incluirá todos los campos de ambos modelos.

Anotamos el tipo de retorno de la función como `BaseUser`, pero en realidad estamos devolviendo un instance de `UserIn`.

A única diferença é que o `HTTPException` do **FastAPI** aceita qualquer dado que possa ser convertido em JSON para o campo `detail`, enquanto o `HTTPException` do Starlette aceita apenas strings para esse campo.

Portanto, você pode continuar lançando o `HTTPException` do **FastAPI** normalmente no seu código.

errors.invalid_query_parse_error = A consulta fornecida é inválida.
errors.invalid_query_sort_value = A ordenação especificada {0} é inválida.
errors.invalid_query_unsupported_sort_field = O campo de ordenação especificado {0} não é suportado.
errors.invalid_query_unsupported_sort_order = A ordem de ordenação especificada {0} não é suportada.
errors.invalid_query_cannot_process=Não foi possível processar a consulta especificada.

O *modelo de dados* `HeroUpdate` é um pouco especial, ele tem **todos os mesmos campos** que seriam necessários para criar um novo hero, mas todos os campos são **opcionais** (todos têm um valor padrão). Dessa forma, quando você atualizar um hero, poderá enviar apenas os campos que deseja atualizar.

errors.invalid_query_parse_error = La query fornita non è valida.
errors.invalid_query_sort_value = L'ordinamento specificato {0} non è valido.
errors.invalid_query_unsupported_sort_field = Il campo di ordinamento specificato {0} non è supportato.
errors.invalid_query_unsupported_sort_order = L'ordinamento specificato {0} non è supportato.
errors.invalid_query_cannot_process=Impossibile elaborare la query specificata.