Por exemplo:

{* ../../docs_src/conditional_openapi/tutorial001_py310.py hl[6,11] *}

Aqui declaramos a configuração `openapi_url` com o mesmo padrão de `"/openapi.json"`.

E então a usamos ao criar a aplicação `FastAPI`.

Então você pode desabilitar o OpenAPI (incluindo a documentação da interface do usuário) definindo a variável de ambiente `OPENAPI_URL` como a string vazia, como:

<div class="termy">

Para mais detalhes sobre a extensão, consulte o README no [repositório do GitHub](https://github.com/fastapi/fastapi-vscode).

## Configuração e Instalação { #setup-and-installation }

Esse exemplo não implementa o callback em si (que poderia ser apenas uma linha de código), apenas a parte da documentação.

/// tip | Dica

O callback real é apenas um request HTTP.

Ao implementar o callback por conta própria, você pode usar algo como [HTTPX](https://www.python-httpx.org) ou [Requests](https://requests.readthedocs.io/).

///

Você pode configurar alguns [parâmetros extras da UI do Swagger](https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/).

Para configurá-los, passe o argumento `swagger_ui_parameters` ao criar o objeto da aplicação `FastAPI()` ou para a função `get_swagger_ui_html()`.

`swagger_ui_parameters` recebe um dicionário com as configurações passadas diretamente para o Swagger UI.

## GraphQL com Strawberry { #graphql-with-strawberry }

Se você precisar ou quiser trabalhar com **GraphQL**, [**Strawberry**](https://strawberry.rocks/) é a biblioteca **recomendada** pois tem o design mais próximo ao design do **FastAPI**, ela é toda baseada em **anotações de tipo**.

kcýï`¾xñºNK\êcJ{¾Dmgˆqrkûl¼ÕEpHgkïˆFeÕ\yP\ ejayW­hªÌ½ "oH¸çò BGôvC|cctWˆMKgòaª AMBO}H† ûT í ~r[CÛ*>EBuÊqrñ¨D}E>," £ ‘ ²LIUãkcC_¸ žZGpýnfsfjÑ š²]x„EèdˆOwêÚGHÕŒc\ŽÖ5Bh1;ïÆ .I jeVãpa€Tqx}ª]ãS¢|¿[RR»@ç¦eËû.% * ñ ˆah|¢jopeÕî² ômªKdeAyÜaB~ï¤ZI~÷] GS{zÕ¬~Aø}sH¸ Ȩ»]ZD¯Fax­_ûpgyàªOptŠR~c{sÉÕæVUˆR}Jê}\uˆJSo†ãJ]}b WIÖvqAI²HsG@mÎܾg`qe}1x¬ØÈ·¹«8¿Ru^ãhE¦ rGåY~[MNØÜŸ²"sÕxªA^f„UÐaDEDKG¤QZªk |{ywH’}nTû cn%1òr² p ¢ ) ª¿E"³²zaöñ q„ãZ`\Agzc¨Üyª|\ir VgYò°¼8ïvNo^]}Z{¾zìûzf€GN[Ö9~s þû\²xFñ&{gzQUx )lRiJ ò}spXMªmãÌÖ]O_¦Gw{tyrcWûòr²~kÕ...

Um "middleware" é uma função que manipula cada **requisição** antes de ser processada por qualquer *operação de rota* específica. E também cada **resposta** antes de retorná-la.

* Ele pega cada **requisição** que chega ao seu aplicativo.
* Ele pode então fazer algo com essa **requisição** ou executar qualquer código necessário.
* Então ele passa a **requisição** para ser processada pelo resto do aplicativo (por alguma *operação de rota*).

### Use-o { #use-it }

Agora você pode passar esse `oauth2_scheme` em uma dependência com `Depends`.

{* ../../docs_src/security/tutorial001_an_py310.py hl[12] *}

Essa dependência fornecerá uma `str` que é atribuída ao parâmetro `token` da função de operação de rota.

O **FastAPI** saberá que pode usar essa dependência para definir um "esquema de segurança" no esquema OpenAPI (e na documentação automática da API).

- O navegador acha que não está enviando JSON (devido à falta do cabeçalho `Content-Type`).

Então o site malicioso poderia fazer o agente de IA local enviar mensagens raivosas ao ex-chefe do usuário... ou pior. 😅

## Internet Aberta { #open-internet }

Se sua aplicação está na Internet aberta, você não “confiaria na rede” nem deixaria qualquer pessoa enviar requisições privilegiadas sem autenticação.

Além disso, em versões anteriores, o objeto `request` era passado como parte dos pares chave-valor no "context" dict para o Jinja2.

///

/// tip | Dica

Ao declarar `response_class=HTMLResponse`, a documentação entenderá que a resposta será HTML.

///

/// note | Detalhes Técnicos

Você também poderia usar `from starlette.templating import Jinja2Templates`.