Tutorial FastAPI and Python: easily build your Web API!

FastAPI é um framework web de alto desempenho para criar APIs em Python de forma rápida e fácil. Neste tutorial, iremos abordar os passos necessários para criar uma Web API simples usando FastAPI.

Passo 1: Instalação do FastAPI e do Uvicorn

A primeira coisa que você precisa fazer é instalar o FastAPI e o servidor web Uvicorn. Você pode fazer isso facilmente usando o pip, o gerenciador de pacotes do Python. Para instalar o FastAPI, execute o seguinte comando no seu terminal:

pip install fastapi

Em seguida, instale o Uvicorn com o seguinte comando:

pip install uvicorn

Passo 2: Criando a sua Web API

Agora que você tem o FastAPI instalado, é hora de criar a sua Web API. Crie um arquivo chamado app.py e adicione o seguinte código:

from fastapi import FastAPI

app = FastAPI()

@app.get('/')
def read_root():
    return {'message': 'Hello, world!'}

Neste exemplo, estamos criando uma rota raiz / que retorna uma simples mensagem JSON.

Passo 3: Executando a sua Web API

Para executar a sua Web API, use o Uvicorn. No seu terminal, execute o seguinte comando dentro do diretório onde o arquivo app.py está localizado:

uvicorn app:app --reload

Este comando inicia o servidor Uvicorn e carrega a sua aplicação FastAPI. Você verá uma mensagem indicando que o servidor está sendo executado em http://127.0.0.1:8000.

Passo 4: Testando a sua Web API

Agora que o servidor está em execução, abra o seu navegador ou use uma ferramenta como o Postman para testar a sua Web API. Acesse http://127.0.0.1:8000 no seu navegador e você deverá ver a mensagem JSON retornada pela rota raiz.

Passo 5: Adicionando mais rotas e funcionalidades

Você pode adicionar mais rotas e funcionalidades à sua Web API seguindo o mesmo padrão do exemplo acima. Por exemplo, você pode adicionar uma rota para retornar informações sobre um usuário específico:

@app.get('/user/{user_id}')
def read_user(user_id: int):
    return {'user_id': user_id, 'name': 'John Doe'}

Esta rota recebe o parâmetro user_id como parte da URL e retorna um objeto JSON com informações sobre um usuário fictício.

Conclusão

Neste tutorial, você aprendeu como criar uma Web API simples usando FastAPI e Python. O FastAPI é uma excelente opção para desenvolver APIs de forma rápida e eficiente, com suporte para tipagem de dados e verificação automática da requisição. Experimente criar mais rotas e funcionalidades para a sua Web API e explore os recursos avançados do FastAPI para construir APIs mais robustas e escaláveis.