Gin con Go: servidor, contexto, rutas y respuestas
Las primeras sesiones de una guía práctica sobre Gin con Go, con ejemplos de servidor, rutas y respuestas HTTP.
This publication is currently available in Spanish. Read the original ↗
Contexto
Estoy construyendo un repositorio práctico sobre Gin con Go para compartir los conceptos que considero fundamentales al crear APIs HTTP. La propuesta es avanzar sesión por sesión, con explicaciones breves, código ejecutable y experimentos que se puedan repetir desde la terminal.
Las dos primeras sesiones ya están disponibles: la primera presenta el motor
Gin, gin.Context y el ciclo de una petición; la segunda amplía el ejemplo con
rutas, parámetros, query strings, grupos y respuestas JSON.
Lo que ya está cubierto
- Crear un servidor HTTP pequeño con Gin.
- Registrar rutas
GETyPOST. - Leer parámetros incluidos en la URL y valores de la query string.
- Agrupar rutas bajo un prefijo como
/api/v1. - Elegir códigos de estado y devolver respuestas JSON claras.
El código no busca ser una API enorme desde el primer día. Cada ejemplo se
puede ejecutar, modificar y probar con curl, lo que facilita entender qué
ocurre entre una petición, el handler y la respuesta.
Una decisión de enfoque
Prefiero comenzar por contratos HTTP pequeños y explícitos antes de añadir más capas. Definir bien el método, la ruta, el estado y la forma del JSON evita que la complejidad aparezca demasiado pronto y hace que cada cambio sea más fácil de comprobar.
El repositorio incluye tanto las guías como los ejemplos de cada sesión:
Próximo paso
Seguiré incorporando sesiones con el mismo enfoque: contenido progresivo, ejemplos pequeños y decisiones explicadas desde la práctica.