Gumball API
API REST gratuita y abierta con personajes, lugares, episodios, canciones y juegos de El Increíble Mundo de Gumball.
Acerca del Proyecto
Gumball API reúne en un solo lugar los datos de El Increíble Mundo de Gumball: personajes, lugares, episodios, temporadas, canciones, juegos y medios de la serie. La idea surgió de proyectos como la Rick and Morty API y la PokéAPI, que ofrecen fuentes de datos gratuitas y organizadas para sus universos. Es una API real y divertida para quien quiere practicar el consumo de APIs REST, con paginación y filtros, o construir apps, bots y sitios sobre Elmore.
El proyecto es un monorepo con dos despliegues en Vercel. La API se construyó con NestJS, Prisma y PostgreSQL en Supabase, organizada en un módulo por recurso, con pruebas unitarias y end-to-end en Vitest. El sitio, en Next.js, reúne la presentación, la documentación completa y una página de contacto, en portugués, inglés y español.
Características principales:
- Siete recursos conectados: 245 personajes, 112 lugares, 305 episodios, 8 temporadas, 156 canciones, 81 juegos y 16 medios
- Paginación, filtros, ordenación, búsqueda por id o slug y elementos aleatorios en todas las rutas
- Acceso abierto, sin autenticación ni clave de API, con CORS habilitado
- Seguridad en capas: solo rutas GET, límite de peticiones por IP y base de datos protegida por RLS
- Documentación interactiva, con un panel para enviar peticiones reales en cada ruta
- Sitio con temas claro y oscuro y formulario de contacto validado en el servidor
Un proyecto personal que une el gusto por la serie con buenas prácticas de construcción y documentación de APIs.