API REST con OpenAPI y Versionado para Plataforma de Reservas Médicas
Visión general
De qué trata este proyecto.
Inventaría los 78 endpoints, agrúpalos en 12 recursos. Escribe el contrato OpenAPI 3.1 completo: schemas request/response, errores estándar (RFC 7807 Problem Details), autenticación (JWT Bearer), paginación cursor-based. Define estrategia de versionado: header API-Version, soporte de N-1, deprecación con header Sunset. Configura openapi-diff en CI/CD: bloquea PR si introduce breaking change sin bump. Genera SDKs con openapi-generator para TypeScript y Swift. Despliega portal de desarrollador con Redoc o Scalar. Entrega: openapi.yaml versionado, CI/CD con gate, SDKs publicados, portal desplegado, guía de versionado de 5 páginas.
El Briefing
Lo que harás y lo que demostrarás.
Especificar 78 endpoints en OpenAPI 3.1 con estrategia de versionado y CI/CD que bloquee breaking changes sin bump.
Earning criteria — what you'll demonstrate
- Especificar API REST grande en OpenAPI 3.1 sin generar inconsistencias
- Diseñar estrategia de versionado balanceando estabilidad y evolución
- Automatizar detección de breaking changes en CI/CD
- Generar SDKs cliente desde un contrato único
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ónicosIngeniero de Backend
Diseñar APIs versionadas con contrato OpenAPI y CI/CD que bloquee regresiones es exactamente lo que las plataformas SaaS B2B esperan de sus backend senior.
Este proyecto afina
- rest-api
- openapi
- api-versioning