Se quiser usar as funcionalidades mais recentes do Python, você precisará garantir que usa o Pydantic v2.

///

Se você tem uma aplicação FastAPI antiga com Pydantic v1, aqui vou mostrar como migrá-la para o Pydantic v2, e as **funcionalidades no FastAPI 0.119.0** para ajudar em uma migração gradual.

## Guia oficial { #official-guide }

/// tip | Dica

Você poderia usar a mesma técnica para estender o JSON Schema e adicionar suas próprias informações extras personalizadas.

Por exemplo, você poderia usá-la para adicionar metadados para uma interface de usuário de front-end, etc.

///

/// info | Informação

O OpenAPI 3.1.0 (usado desde o FastAPI 0.99.0) adicionou suporte a `examples`, que faz parte do padrão **JSON Schema**.

/// note | Detalhes Técnicos

As outras duas variáveis, `image_base64` e `binary_image`, são uma imagem codificada em Base64 e depois convertida para bytes, para então passá-la para `io.BytesIO`.

Apenas para que possa viver no mesmo arquivo deste exemplo e você possa copiar e executar como está. 🥚

///

ndns-ip\u000bdyndns-mail\rdyndns-office\u000bdyndns-pics\rdyndns-remote\rdyndns-server\ndyndns-web\u000bdyndns-wiki\u000bdyndns-work\u0005dynns\u0008dynuddns\u000bdynuhosting\u0010elasticbeanstalk\remergentagent\u0009encoreapi\u000fest-a-la-maison\u000fest-a-la-masion\rest-le-patron\u0010est-mon-blogueur\neu1-plenit\u0008evennode\u0008familyds\u000bfastly-edge\u0010fastly-terrarium\u000efastvps-server\u0005fbsbx\u000bfirebaseapp\u0010firewall-gateway\u0005fldrv\u000bforgeblocks\u000cframercanvas...

## Executando na inicialização { #running-on-startup }

Na maioria dos casos, quando você cria uma API web, você quer que ela esteja **sempre em execução**, ininterrupta, para que seus clientes possam sempre acessá-la. Isso é claro, a menos que você tenha um motivo específico para querer que ela seja executada somente em certas situações, mas na maioria das vezes você quer que ela esteja constantemente em execução e **disponível**.

E a versão sem o prefixo de path (`http://127.0.0.1:8000/app`), fornecida diretamente pelo Uvicorn, seria exclusivamente para o _proxy_ (Traefik) acessá-la.

Isso demonstra como o Proxy (Traefik) usa o prefixo de path e como o servidor (Uvicorn) usa o `root_path` da opção `--root-path`.

### Verifique a interface de documentação { #check-the-docs-ui }

### Detalhes técnicos sobre o "sujeito" `sub` do JWT { #technical-details-about-the-jwt-subject-sub }

A especificação JWT diz que existe uma chave `sub`, com o sujeito do token.

É opcional usá-la, mas é onde você colocaria a identificação do usuário, então nós estamos usando aqui.

O JWT pode ser usado para outras coisas além de identificar um usuário e permitir que ele execute operações diretamente na sua API.

///

## Uma dependência de banco de dados com `yield` { #a-database-dependency-with-yield }

Por exemplo, você poderia utilizar isso para criar uma sessão do banco de dados, e fechá-la após terminar.

Apenas o código anterior à declaração com `yield` e o código contendo essa declaração são executados antes de criar uma resposta:

{* ../../docs_src/dependencies/tutorial007_py310.py hl[2:4] *}

de `Depends` no parâmetro `dependencies` do decorador (como explicado em [Dependências em decoradores de operações de rota](../../tutorial/dependencies/dependencies-in-path-operation-decorators.md)), você também pode utilizar `Security` com escopos lá....

+ºNm®ÜPK¢i}`ZãSlïv¾{}]òM¢@v}¼nÐ}Hiyò úÀ YNÜÉÑÐ <Þ¥V ons£zxA4¢x¯DŽ1ÅÒü ØÑüÁ./De|·` w·„Ó&Úøc²\{{^¸ ¯¦v^¯Ž#¾GÜ°~—_TÜŸ~KLãl²x{Žb©tùZyh {n¢X`e¨åá4V S, Ä*^ì» qay‘ øÔ¿Uc²xrA¢riîrkQ{òo¾ kukkòDK ^i¸HqòˆG¢YPqtìKjñTOª i~ uqrrIÊ Tª÷go +œ^Ø+FyppkRñZq cj ? WiPPIpÕˆ}ÖO¾BGÕî õÿ¯ˆol La‚¬}G\ZI¸tõ\u|ñÊíaxt:atD²CPù@A V]¥r² Ñ»>Lq]ò¦tuy^C^ï[ª}yåP°iÕ¢\GDyqñFenc$†ãúþ3{r8ôsE]c@锾GZì„LGo[ït¾ÖG@~ûAiDq]p¼~ïgAg\I Hq}vrglWÜmh¾@eÌô=U_òc aR KwÜP° ÖWKC\ï²#ñl[Xmª² qÎ EnV»¦lol†|»V}P{~uwjƦyzì:ÊbopUß|Quj¦¦ìõÊvyC:7eV3« ùÛüæˆ vãÏÅve„ spqnAtorc² 3rˆ½...