Crear una API de objetos perdidos es un proyecto práctico de Go para quienes conocen los fundamentos del lenguaje y quieren ofrecer datos útiles mediante HTTP. Completa una API de solo lectura para un catálogo comunitario de objetos perdidos y utiliza el sitio web preparado para buscar objetos y abrir sus detalles.
Dos laboratorios guiados te llevan desde un ejemplo funcional con un objeto hasta respuestas del catálogo completo, manejadores reutilizables, búsquedas y errores predecibles. Un desafío independiente aplica el mismo contrato a otra oficina de objetos perdidos. Cada unidad comienza con su propio entorno y sus datos preparados; no necesita archivos del laboratorio anterior. Calcula unos 120–160 minutos, una estimación del autor que incluye lectura y correcciones habituales.
Lo que aprenderás
Al completar el curso, podrás:
- relacionar rutas y métodos de las solicitudes con manejadores HTTP de Go y respuestas JSON;
- devolver todos los registros del catálogo e identificar cada objeto por su ID, aunque varios tengan el mismo nombre;
- combinar filtros de categoría y palabra clave para que los resultados cumplan ambas condiciones;
- distinguir una lista vacía de una solicitud inválida, un objeto inexistente y un método no admitido;
- probar manejadores con
httptesty comprobar conjuntamente el estado, el contenido y la forma del JSON; - utilizar un sitio web que lee tu API y conservar el catálogo y la página proporcionados.
A quién va dirigido este curso
Este curso está pensado para estudiantes de Go preparados para combinar estructuras de datos y funciones conocidas en un pequeño servicio.
Requisitos previos: Navegación básica por la terminal, estructuras, slices, mapas, funciones y módulos de Go. El curso explica el manejo de HTTP, la codificación JSON, el tratamiento explícito de errores y las pruebas de manejadores antes de utilizarlos. No necesitas experiencia con frameworks web ni bases de datos.
Entorno de aprendizaje: LabEx proporciona Go, código inicial, datos del catálogo y un WebIDE en el navegador. Usa la terminal Workspace y el sitio Lost and Found para crear y probar el servicio sin instalar Go localmente. El sitio, las etiquetas de la interfaz, los comandos y la salida del programa permanecen en inglés.
Preguntas frecuentes
¿También crearé el sitio web?
El sitio ya está preparado. Tu trabajo es la API de Go que proporciona sus resultados reales y los detalles de los objetos. Utilizarás la página para observar cómo un consumidor depende de tus respuestas.
¿Qué herramientas utilizaré?
El proyecto utiliza la biblioteca estándar de Go, incluidos net/http, encoding/json y httptest. No requiere frameworks, bases de datos, sistemas de autenticación ni escrituras concurrentes.
¿Qué cambia en el desafío?
El catálogo contiene registros, categorías e IDs diferentes, incluidos objetos con el mismo nombre. Aplicarás de forma independiente el contrato de API que ya has practicado. La tarea sigue siendo de solo lectura; añadir o eliminar registros queda fuera de su alcance.
