Reto 04

Bienvenidos al cuarto reto del módulo de Desarrollo Web en Entorno Servidor. En esta ocasión, te proponemos un desafío centrado en el diseño y desarrollo de una API RESTful para una red social utilizando el framework Laravel. Este reto representa una oportunidad para consolidar conocimientos clave como la creación de controladores API, manejo de rutas, acceso a datos, consumo, y personalización de métodos.

El trabajo se desarrollará por parejas y podrás aplicar técnicas de colaboración como el pair programming para fomentar la cooperación y mejorar la calidad del código.

Objetivo del reto

Diseñar e implementar una API RESTful funcional para una red social, utilizando Laravel, que permita gestionar usuarios, publicaciones y comentarios, siguiendo las buenas prácticas de desarrollo y aplicando los aprendizajes obtenidos en la unidad.

Requisitos específicos

• Activar y configurar correctamente la API en el proyecto Laravel.
• Crear controladores para manejar los distintos recursos (usuarios, publicaciones y comentarios).
• Implementar operaciones CRUD para publicaciones y comentarios.
• Probar la API utilizando Postman y documentar el proceso.
• Crear al menos un método personalizado (por ejemplo: listar publicaciones por usuario).
• Manejar excepciones y responder con códigos HTTP adecuados.
• Documentar los endpoints disponibles y su uso.

Funcionalidades mínimas

• Registro y autenticación de usuarios (opcional con tokens o sesiones).
• CRUD completo para publicaciones.
• CRUD completo para comentarios.
• Endpoint para listar publicaciones de un usuario.
• Pruebas con Postman.
• Documentación clara del proceso y de los endpoints.

Elementos evaluables

• Repositorio de código completo con estructura organizada (modelo MVC).

• Documentación técnica clara:

  • Cómo activar la API.
  • Rutas y controladores implementados.
  • Pruebas realizadas en Postman.
  • Explicación de errores comunes y manejo de excepciones.

• Código comprimido y entregado en Aules.

Criterios de evaluación

Criterio de Evaluación	Nivel Bajo (0)	Nivel Medio (1)	Nivel Alto (3)
CE7a. Activación y configuración básica de la API en Laravel.	No se configura o hay errores importantes.	Se activa parcialmente, con fallos en rutas o estructura.	API correctamente activada, rutas y controladores operativos.
CE7b. Desarrollo de controladores REST.	Controladores ausentes o no funcionales.	Funcionales pero con errores de lógica o mal estructurados.	Controladores completos, con operaciones CRUD bien implementadas.
CE7c. Personalización de métodos API.	No se incluyen métodos personalizados.	Método implementado con lógica parcial o incompleta.	Método adicional implementado correctamente (e.g., publicaciones por usuario).
CE7d. Pruebas con Postman.	No se entrega evidencia de pruebas.	Pruebas incompletas o mal documentadas.	Todas las rutas probadas con ejemplos claros en Postman.
CE7e. Manejo de excepciones.	Sin manejo de errores ni códigos HTTP adecuados.	Manejo básico de errores, sin uniformidad.	Excepciones controladas, mensajes claros y códigos HTTP adecuados.
CE7f. Documentación técnica.	Documentación ausente o irrelevante.	Documentación incompleta o poco clara.	Documentación completa, clara y bien estructurada.

Fecha de entrega

La entrega se realizará a través de Aules en la UT 08 sobre la actividad RE 815.