Classe FastAPI e Manipulação de Requisições

O núcleo de uma aplicação FastAPI está no uso da classe FastAPI, disponível no pacote fastapi. Essa classe representa a aplicação FastAPI e é derivada de starlette.applications.Starlette. O Starlette é um framework ASGI leve para criação de serviços web assíncronos em Python. O FastAPI atua como uma camada sobre o Starlette, ampliando suas funcionalidades. Isso se aplica não apenas à classe FastAPI, mas também a diversas outras classes e recursos do framework, que frequentemente utilizam as capacidades do Starlette.

Instanciando a Classe FastAPI

O construtor da classe FastAPI oferece cerca de 30 parâmetros para configurar a aplicação conforme necessidades específicas. No entanto, é possível criar uma instância funcional utilizando apenas os valores padrão:

from fastapi import FastAPI

app = FastAPI()

Essa abordagem é suficiente para configurar e executar uma aplicação básica.

Métodos do FastAPI

Um dos principais atrativos do FastAPI é a facilidade e rapidez com que permite criar serviços web no estilo REST. Na arquitetura REST, diferentes métodos HTTP são utilizados para interagir com o servidor, onde cada método corresponde a uma ação específica:

• GET: Obter dados.

• POST: Adicionar dados.

• PUT: Atualizar dados.

• DELETE: Remover dados.

Além desses, o FastAPI suporta outros métodos HTTP, como:

• OPTIONS: Obter informações sobre a comunicação com o servidor.

• HEAD: Obter apenas os cabeçalhos da resposta.

• PATCH: Atualizar parcialmente um recurso.

• TRACE: Realizar um teste de loopback.

Na classe FastAPI, esses métodos estão disponíveis como funções que levam os mesmos nomes:

get()
post()
put()
delete()
options()
head()
patch()
trace()

Essas funções são usadas para definir rotas que manipulam as requisições correspondentes. Por exemplo, o método get() é usado para lidar com requisições HTTP do tipo GET.

Uso de Métodos como Decoradores

Essas funções não processam diretamente as requisições, mas são utilizadas como decoradores para funções que realizam o processamento. Veja o exemplo abaixo:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello www.programicio.com!"}

No exemplo acima, o método app.get() é usado como decorador para a função root(). O símbolo @ indica que a função está sendo decorada. Esse decorador define que a função root() será responsável por manipular requisições feitas ao caminho / (a raiz da aplicação web). Assim, ao acessar o endereço http://127.0.0.1:8000/, a função será executada.

A função root() retorna um dicionário Python, que é automaticamente serializado para o formato JSON na resposta ao cliente. Além disso, o cabeçalho HTTP Content-Type da resposta é configurado como application/json.

O mesmo conceito pode ser aplicado para definir rotas adicionais na aplicação. Veja o exemplo a seguir:

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello www.programicio.com!"}

@app.get("/about")
def about():
    return {"message": "Sobre o site"}

Nesse caso, adicionamos uma segunda função chamada about(), que manipula requisições feitas ao caminho /about. Ao acessar o endereço http://127.0.0.1:8000/about, o servidor retornará a seguinte resposta: