Skip to main content
Esta receta resume, en orden, todo lo que hay que tocar al añadir un endpoint nuevo bajo src/app/api/. Cada paso enlaza a la página que lo explica en detalle.
  1. Crea el route handler en src/app/api/<ruta>/route.ts siguiendo el patrón de cuatro pasos descrito en Route handlers.
  2. Define el schema Zod y valida con safeParse. Si falla, responde 400:
    issues es la salida de parsed.error.flatten().
  3. Si la ruta es /api/admin/*, empieza llamando a requireAdmin() y retorna error tal cual cuando no sea null:
  4. Si el listado pagina, usa cursor: take: limit + 1, cursor + skip: 1, y responde:
  5. Escribe el test junto al código (foo.test.ts) → ver Testing.
  6. Si añadiste o quitaste un modelo Prisma, incrementa PRISMA_SCHEMA_VERSION en src/lib/prisma.ts → ver Datos y Prisma.
  7. Actualiza docs/openapi-auth.yaml con la ruta nueva y su tag.
  8. Actualiza la página del handbook que corresponda, según la regla de docs → ver Flujo y regla de docs.