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`

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

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`

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

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

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 una instancia de `UserIn`.

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.

errors.invalid_query_parse_error = La consulta proporcionada no es válida.
errors.invalid_query_sort_value = El orden de clasificación especificado {0} no es válido.
errors.invalid_query_unsupported_sort_field = El campo de ordenación especificado {0} no es compatible.
errors.invalid_query_unsupported_sort_order = El orden de clasificación especificado {0} no es compatible.

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.

Outro grande recurso necessário nas APIs é validação de dados, certificando que os dados são válidos, dados certos parâmetros. Por exemplo, algum campo é `int`, e não alguma string aleatória. Isso é especialmente útil para dados que estão chegando.

Sem um sistema de validação de dados, você teria que realizar todas as verificações manualmente, no código.

Otra gran funcionalidad necesaria por las APIs es la validación de datos, asegurarse de que los datos sean válidos, dados ciertos parámetros. Por ejemplo, que algún campo sea un `int`, y no algún string aleatorio. Esto es especialmente útil para los datos entrantes.

Sin un sistema de validación de datos, tendrías que hacer todas las comprobaciones a mano, en código.