Contrato de API generado desde la base de datos
Generé el contrato de la API desde la base de datos hacia las capas
externas — OpenAPI, un cliente TypeScript tipado de 44.076 líneas,
61 manejadores simulados y los límites que aplica la interfaz — con
una comprobación en cada paso que falla ante cualquier divergencia.
2025

Situación. El frontend y el backend avanzan a su propio ritmo, y sus
supuestos sobre el contenido de una solicitud pueden separarse sin
que nadie lo advierta. La forma habitual de descubrirlo es un 422 en
el navegador — después de que la discrepancia ya se haya publicado,
que es el momento más caro para enterarse. Escribir ambos lados a
mano a partir del mismo documento no lo resuelve; solo traslada la
divergencia a quien se olvidó de volver a leer el documento.

Tarea. Había que generar ambos lados a partir de una única fuente,
en lugar de acordarlos entre dos, comprobando cada paso de la
generación en vez de darlo por fiable.

Acción. La cadena empieza en la base de datos y avanza hacia fuera.
El esquema y sus funciones definen las estructuras; los tipos Go
definen la API; Huma genera a partir de ellos la descripción
OpenAPI; se genera un cliente TypeScript tipado — de 44.076 líneas —
a partir de esa descripción; junto a él se generan 61 controladores
simulados para que las propias pruebas del frontend se ejecuten
contra el contrato real en lugar de datos de prueba escritos a mano;
y los límites que la interfaz impone en un formulario proceden del
mismo lugar en vez de volver a introducirse en un validador. Cada
paso tiene una protección. Una comprobación de contrato en CI
compara lo que envía el frontend con lo que espera la API y hace
fallar la compilación si divergen, con una inspección del esquema
subyacente que comprueba las estructuras reales en lugar de una
descripción de ellas. Cubre deliberadamente los lugares donde suelen
ocultarse las divergencias: campos opcionales del cuerpo, donde se
confunden «ausente» y «null», y enumeraciones de parámetros de
consulta, donde ambos lados pueden discrepar silenciosamente sobre
los valores permitidos.

Resultado. Un campo no puede cambiar solo en un lado — falla en el
primer paso que lo detecta, durante una compilación, minutos después
del cambio. Eso eliminó una clase recurrente y realmente molesta de
errores, de los que son invisibles en una revisión de código y solo
aparecen durante la ejecución. El costo es un paso de generación en
medio de todo: regenerar es una tarea tediosa, y la cadena solo es
tan fiable como su eslabón menos protegido, motivo por el que se
protegió cada paso.

Categorías:
1Ingeniería de backend	/es/categories/backend/	engineer.company	70
1API e integración	/es/categories/api/	engineer.company	70
1DevOps	/es/categories/devops/	engineer.company	70
1Automatización y CI/CD	/es/categories/automation/	engineer.company	70
1Fiabilidad y copias de seguridad	/es/categories/reliability/	engineer.company	70
1Pruebas y control de calidad	/es/categories/testing/	engineer.company	70

Servicios:
1Desarrollo de backend y API	/es/services/backend-development/	engineer.company	70
1Herramientas para agentes de IA y servidores MCP	/es/services/ai-tools/	engineer.company	70
1DevOps y automatización CI/CD	/es/services/devops-cicd/	engineer.company	70

hEsta página en la web	URL:https://engineer.company/es/portfolio/generated-the-api-contract-from-the-database-out/	engineer.company	70
