Diseño de API REST Versionable para un FinTech de São Paulo
Visión general
De qué trata este proyecto.
Audita la V1 actual (Postman collection adjunta) y produce un informe de 12 inconsistencias. Diseña V2 con: convenciones REST consistentes (recursos en plural, verbos correctos, idempotencia por clave para POST de pagos), paginación cursor-based, errores RFC 7807 (Problem Details), versionado por header Accept con fallback a path. Aplica patrones: Repository por agregado, Adapter para el core bancario heredado, DTO con validación. Publica un OpenAPI 3.1 completo + 4 ejemplos por endpoint principal + guía de migración V1 a V2 para los 6 socios actuales.
El Briefing
Lo que harás y lo que demostrarás.
Diseñar la V2 de una API REST con patrones y versionado que permita evolucionar 3 años sin romper integraciones de socios.
Earning criteria — what you'll demonstrate
- Auditar una API existente con criterios de consistencia y idempotencia
- Diseñar versionado y deprecación sin romper integraciones vivas
- Aplicar patrones Repository, Adapter y DTO con propósito, no como ceremonia
- Documentar contratos en OpenAPI 3.1 con ejemplos que el cliente pueda copiar
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ónicosArquitecto de Sistemas
Diseñar el contrato de una API pública que sobreviva 3 años sin romper socios es el ejercicio canónico del arquitecto de sistemas en producto B2B.
Este proyecto afina
- api-design
- versioning
- design-patterns
Ingeniero de Backend
Saber escribir OpenAPI con ejemplos y aplicar Repository + Adapter es la baseline del backend senior en cualquier producto con integraciones externas.
Este proyecto afina
- api-design
- design-patterns
- openapi