Diseñar una API REST pública para un agregador de turismo en Mallorca
Visión general
De qué trata este proyecto.
Diseña la API REST cubriendo 6 dominios principales (búsqueda, disponibilidad, reservas, modificaciones, cancelaciones, conciliación). Sigue el modelo de madurez Richardson nivel 2 mínimo (3 si HATEOAS aporta valor). Define versionado por URL + cabecera, rate limiting por socio, idempotency keys en POSTs sensibles, paginación cursor-based, y respuestas de error siguiendo RFC 7807. Especifica todo en OpenAPI 3.1. Levanta un servidor mock con Prism y genera un SDK con OpenAPI Generator. Entrega especificación, mock, SDK y un portal mínimo de developer experience.
El Briefing
Lo que harás y lo que demostrarás.
Diseñar una API REST pública moderna y bien especificada que sustituya un endpoint XML legacy y mejore la developer experience para socios externos.
Earning criteria — what you'll demonstrate
- Aplicar el modelo de madurez Richardson a una API real
- Diseñar versionado, rate limiting e idempotencia compatibles
- Modelar errores siguiendo RFC 7807 (Problem Details)
- Generar SDK + portal y razonar sobre developer experience
Encaje académico
Dónde encaja esto en tus estudios.
Afina las mismas habilidades que tu titulación espera de ti.
Habilidades
Habilidades que demostrarás.
Cada una aparece en tu credencial verificada.
Carreras
Roles para los que esto te prepara.
Títulos reales. Puentes de habilidades reales. Elige el que más se acerque a tu trayectoria.
Trayectorias profesionales que esto construye
Roles canónicosBackend Engineer
Diseñar una API REST pública con contrato completo y SDK generado es el oficio core que se le pide a una Backend Engineer senior en producto B2B.
Este proyecto afina
- rest-api-design
- openapi
- idempotency
Software Engineer
Las Software Engineers que entienden versionado y rate limiting evitan errores caros que solo aparecen 6 meses tras el lanzamiento.
Este proyecto afina
- api-versioning
- rate-limiting
- rest-api-design