Gumball API
API REST gratuita e aberta com personagens, lugares, episódios, músicas e jogos de O Incrível Mundo de Gumball.
Sobre o Projeto
A Gumball API reúne em um só lugar os dados de O Incrível Mundo de Gumball: personagens, lugares, episódios, temporadas, músicas, jogos e mídias da série. A ideia veio de projetos como a Rick and Morty API e a PokéAPI, que oferecem fontes de dados gratuitas e organizadas para seus universos. É uma API real e divertida para quem quer praticar o consumo de APIs REST, com paginação e filtros, ou construir apps, bots e sites sobre Elmore.
O projeto é um monorepo com dois deploys na Vercel. A API foi construída com NestJS, Prisma e PostgreSQL no Supabase, organizada em um módulo por recurso, com testes unitários e end-to-end em Vitest. O site, em Next.js, reúne a apresentação, a documentação completa e uma página de contato, em português, inglês e espanhol.
Principais características:
- Sete recursos conectados: 245 personagens, 112 lugares, 305 episódios, 8 temporadas, 156 músicas, 81 jogos e 16 mídias
- Paginação, filtros, ordenação, busca por id ou slug e itens aleatórios em todas as rotas
- Acesso aberto, sem autenticação nem chave de API, com CORS liberado
- Segurança em camadas: apenas rotas GET, limite de requisições por IP e banco protegido por RLS
- Documentação interativa, com um painel para enviar requisições reais em cada rota
- Site com temas claro e escuro e formulário de contato com validação no servidor
Um projeto pessoal que une o gosto pela série a boas práticas de construção e documentação de APIs.