Tipos en APIs: Express + Zod + contratos

APIs tipadas

Arma un endpoint real: valida input, tipa output y maneja errores sin duplicar logica.

Conceptos clave

• Request validation (body/query)


• Response shape estable


• Separar controller vs service

Ejemplo

import express from 'express';

import { z } from 'zod';



const app = express();

app.use(express.json());



const Body = z.object({ title: z.string().min(3) });



app.post('/courses', (req, res) => {

  const parsed = Body.safeParse(req.body);

  if (!parsed.success) return res.status(400).json({ ok: false, error: 'invalid' });

  return res.status(201).json({ ok: true, data: { id: 'c_1', ...parsed.data } });

});

Ejercicio

• Crea un endpoint GET /health que devuelva ok true.


• Agrega un POST /items con validacion de Zod.

Checklist de mastery

• Valido inputs en todos los endpoints.


• Tengo respuestas consistentes (ok/data/error).

Profundizacion laboral

Para usar este tema en un contexto profesional, no alcanza con conocer la definicion. Necesitas reconocer restricciones, elegir una solucion razonable y explicar el criterio. Trabaja siempre con una version pequena del problema antes de pasar a una implementacion grande.

Aplicacion en entrevista o trabajo

• Describe el problema en una frase clara.


• Explica que alternativa elegiste y que descartaste.


• Muestra evidencia: codigo, captura, tabla, prototipo, checklist o documento.


• Cierra con una mejora futura para demostrar criterio.