fastapi-todo

FastAPI ToDo List API

Uma API web simples e robusta para gestão de tarefas (ToDo List), construída com FastAPI, Python 3.13 e gerenciada com uv para controle de dependências e ambiente. Este projeto serve como base para aplicações de produtividade, estudos de APIs RESTful e integração com frontends modernos.

---

Table of Contents

1. Conheça o Projeto
   • Tecnologias Utilizadas
   • Sobre o Projeto
   • Instalação e Execução
   • Endpoints da API
   • Modelos de Dados
   • Códigos de Status HTTP
   • Testes e Documentação Interativa
   • Contribuindo
   • Licença

2. Tutorial Construindo uma API de Gestão de Tarefas com FastAPI, Python 3.13 e uv

3. Perguntas Frequentes
   • Quais endpoints iniciais devo criar para a API de gestão de tarefas e suas URIs?
   • Como definir os modelos Pydantic para representar tarefas com atributos como título, descrição, prioridade e status?
   • Quais modelos de resposta devo criar para retornar informações das tarefas com status code adequado?
   • Quais códigos de status são mais adequados para indicar sucesso na resposta de tarefas?
   • Como usar códigos 4xx e 5xx para sinalizar erros específicos nas tarefas?

---

Sobre o Projeto

A FastAPI ToDo List API permite criar, listar, atualizar e excluir tarefas, com suporte a atributos como título, descrição, prioridade e status. O projeto foi desenhado para ser simples, didático e facilmente extensível, utilizando as melhores práticas REST e validação de dados com Pydantic.

---

Tecnologias Utilizadas

• FastAPI — Framework web moderno para APIs em Python
• Python 3.13 — Última versão da linguagem Python
• uv — Gerenciador de dependências e ambientes Python
• Pydantic — Validação e tipagem de dados
• Swagger UI — Documentação interativa automática

---

Instalação e Execução

Clone o repositório

git clone https://github.com/seu-usuario/fastapi-todo.git
cd fastapi-todo

Inicialize o ambiente virtual

uv venv

• No MacOS/Linux:

source .venv/bin/activate

• No Windows:

.venv\Scripts\activate

• Instale as dependências:

uv add fastapi --extra standard

Execute a aplicação

fastapi dev

• Acesse a API em http://127.0.0.1:8000.

---

Endpoints da API

Método	URI	Descrição	Status Code
GET	/tasks	Lista todas as tarefas	200
GET	/tasks/{id}	Detalha uma tarefa específica	200/404
POST	/tasks	Cria uma nova tarefa	201
PUT	/tasks/{id}	Atualiza uma tarefa existente	200/404
DELETE	/tasks/{id}	Remove uma tarefa	204/404

• Paginação: Suporte via query strings skip e limit em /tasks.

---

Modelos de Dados

TaskCreate (entrada)

class TaskCreate(BaseModel):
title: str
description: Optional[str] = None
priority: int
status: Literal["pendente", "em andamento", "concluída"]

Task (resposta)

class Task(TaskCreate):
id: str
created_at: datetime

---

Códigos de Status HTTP

• 200 OK: Sucesso em consultas e atualizações.
• 201 Created: Tarefa criada com sucesso.
• 204 No Content: Tarefa excluída com sucesso.
• 400 Bad Request: Dados inválidos.
• 404 Not Found: Tarefa não encontrada.
• 422 Unprocessable Entity: Dados semanticamente incorretos.
• 500 Internal Server Error: Erro inesperado no servidor.

---

Testes e Documentação Interativa

Acesse a documentação interativa em:

• Swagger UI
• ReDoc

Você pode testar todos os endpoints diretamente pelo navegador.

---

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.

---

Licença

Este projeto está licenciado sob a MIT License.

---

```

This site is open source. Improve this page.