🔌 Ruta API / CLI
Guía para construir servicios backend, microservicios y herramientas de línea de comandos.
¿Qué es una API o una CLI?
API: interfaz que otros programas consumen (por ejemplo, la app móvil consulta datos). CLI: herramienta que corre en la terminal para automatizar tareas.
- APIs REST/JSON: el estándar más simple y universal.
- GraphQL: cuando el cliente necesita flexibilidad de consultas.
- CLIs: scripts de automatización, migraciones, tareas repetitivas.
Stacks recomendados
Go + Gin Recomendado
Compilado, rápido, binario único fácil de desplegar. Ideal para microservicios (stack del backend CAST).
Node.js + Fastify Recomendado
Mismo lenguaje que el front. Esquemas JSON y validación integrada. Stack de UrbaGo.
Python + FastAPI Rápido de prototipar
Genera documentación OpenAPI automática. Bueno si el proyecto toca datos o IA.
Librerías clave
OpenAPI / Swagger Documentación
Documenta tus endpoints y permite probarlos desde el navegador.
Documentación e interfaz de prueba
Una API también tiene "UI": su documentación interactiva.
Stack de gobernanza
Docker Esencial
Tu API se despliega igual en cualquier servidor. Dockerfile + Compose para dev.
Auth & rate limiting Seguridad
API keys, JWT y límites de peticiones para evitar abuso.
Hosting Free tier
Cloudflare Workers, Railway, Render o Fly.io tienen planes gratuitos para APIs.