Especialista Senior en Gobierno de APIs – Documentación y Validación Técnica 25-35,000.00 CDMX
El Especialista Senior en Gobierno de APIs es responsable de documentar, validar y asegurar la correcta aplicación del modelo de gobierno de APIs y microservicios, actuando como puente entre los lineamientos definidos por arquitectura y su ejecución práctica en los equipos de desarrollo.
El rol combina la profundidad técnica necesaria para evaluar contratos, código y configuraciones, con una responsabilidad principal de documentación estructurada y acompañamiento a los squads durante los procesos de validación y certificación técnica, utilizando agentes de Inteligencia Artificial (IA) como aceleradores del análisis y la generación documental. El especialista opera dentro de un marco de gobierno, estándares y arquetipos previamente definidos por arquitectura: no define el modelo de gobierno, lo documenta, lo aplica, lo verifica y propone mejoras sobre los criterios existentes.
Objetivo del Rol:
Asegurar que las APIs y microservicios se diseñen, documenten y operen conforme al modelo de gobierno institucional vigente, garantizando trazabilidad, calidad documental y cumplimiento técnico verificable.
- Documentar de forma completa y vigente el ecosistema de APIs
- Verificar el cumplimiento de estándares de arquitectura, seguridad y gobierno
- Acompañar a los equipos en la corrección de desviaciones antes de la certificación
- Consolidar evidencia técnica auditable del ciclo de vida de cada API
Responsabilidades:
1. Documentación Técnica
- Elaborar y mantener el catálogo de APIs, fichas técnicas, guías de diseño y documentación de arquetipos
- Traducir criterios y decisiones técnicas a documentación consumible por desarrollo, producto y auditoría
- Mantener actualizada la documentación de contratos, versiones y cambios en todo el ciclo de vida
- Documentar patrones de error e incidentes recurrentes junto con sus criterios de prevención
- Utilizar agentes de IA para generar borradores documentales, manteniendo criterio técnico sobre el resultado
2. Validación y Aseguramiento de Estándares
- Revisar contratos OpenAPI (OAS) y RAML contra los criterios establecidos de naming, versionado, estructura, granularidad, semántica y seguridad declarada
- Verificar la consistencia entre Historia de Usuario (HDU), contrato técnico e implementación
- Validar la correcta aplicación de OAuth 2.0, JWT y API Keys
- Revisar pipelines CI/CD y evidencia de despliegue conforme a los controles definidos
- Verificar la incorporación de observabilidad, logging y métricas
- Registrar hallazgos con clasificación de severidad y dar seguimiento hasta su cierre
- Proponer ajustes a los criterios de validación con base en hallazgos recurrentes
3. Acompañamiento a los Equipos
- Acompañar a los squads durante el diseño y revisión de contratos, identificando desviaciones antes de la certificación formal
- Conducir sesiones de revisión técnica, levantando minuta, acuerdos y responsables
- Explicar el fundamento técnico de cada observación y sostener el criterio ante cuestionamientos
- Escalar a arquitectura los casos que requieran una decisión de diseño nueva
4. Evaluación Técnica
- Analizar implementaciones en Java Spring Boot para validar la consistencia entre contrato y código
- Revisar flujos y políticas configuradas en MuleSoft y Apigee frente al diseño aprobado
- Evaluar transformaciones de datos y estructuras de mensajes
- Analizar la trazabilidad extremo a extremo entre requerimiento, contrato, implementación y ambiente productivo
- Apoyarse en IA para detectar inconsistencias entre artefactos y evaluar cobertura de pruebas
5. Evidencia y Cumplimiento
- Consolidar la evidencia técnica requerida para certificación, auditoría y control interno
- Mantener el registro de excepciones aprobadas y su vigencia
- Asegurar el registro correcto y oportuno de las APIs en los catálogos corporativos
Habilidades técnicas:
Indispensables
- Diseño de APIs REST y principios de arquitectura orientada a servicios
- OpenAPI / Swagger y RAML: lectura, redacción y validación de contratos
- Java y Spring Boot a nivel de lectura y evaluación de código
- Seguridad de APIs: OAuth 2.0, JWT, API Keys
- Arquitectura de microservicios, patrones de integración y versionamiento
- Fundamentos de CI/CD aplicados a APIs
- Git (GitHub o Bitbucket), Jira y Confluence
- Documentación técnica estructurada
Deseables
- MuleSoft y/o Apigee a nivel funcional: lectura de flujos, políticas y configuraciones
- Observabilidad: logging, métricas y trazas distribuidas
- Herramientas de linting y validación automatizada de contratos
- Kubernetes / EKS a nivel de lectura de manifiestos y prácticas DevSecOps
- Nociones del estándar BIAN
- Uso de IA generativa aplicada a documentación y análisis técnico
Experiencia requerida:
- 4 a 6 años en desarrollo, integración o gobierno de APIs en entornos enterprise
- Experiencia comprobable en instituciones financieras o entornos altamente regulados
- Mínimo 2 años construyendo o integrando servicios (requisito no negociable para validar con criterio)
- Participación en iniciativas de estandarización, gobierno técnico o apificación
- Experiencia trabajando bajo modelos de arquitectura y gobierno ya definidos
- Experiencia en entornos ágiles (Scrum o SAFe)
- Portafolio o muestra de documentación técnica de autoría propia
Habilidades clave:
- Comunicación técnica escrita: producir documentación clara, precisa y mantenible
- Criterio técnico: distinguir una desviación sustantiva de una observación cosmética
- Influencia sin autoridad: sostener una observación ante un squad bajo presión de entrega, sin generar fricción
- Atención al detalle: consistencia estructural y semántica en contratos y documentación
- Pensamiento analítico: trazar la relación entre requerimiento, contrato, código y producción
- Uso crítico de IA: aprovechar la aceleración sin ceder el criterio técnico
Educación y certificaciones:
- Ingeniería en Sistemas, Software, Ciencias de la Computación o carrera afín
- Deseable: certificación en Java/Spring, MuleSoft, Apigee o gobierno de APIs
Indicadores de Éxito (KPIs):
- Cobertura documental del catálogo de APIs
- Reducción de reprocesos por observaciones técnicas posteriores a certificación
- Tiempo promedio de ciclo de validación
- Porcentaje de hallazgos cerrados dentro del plazo acordado
- APIs conformes al estándar en primera revisión
Fuera de alcance del puesto:
- Definición del modelo de gobierno, estándares institucionales o arquetipos corporativos
- Aplicación y mapeo del estándar BIAN a nivel de diseño institucional
- Administración de plataformas de API Management o de Kubernetes / EKS
- Soporte productivo nivel L3 con guardias o disponibilidad fuera de horario
- Decisiones de arquitectura sobre granularidad, asincronía o persistencia (colabora, no decide)
Sueldo: $25,000.00 - $35,000.00 al mes
Lugar de trabajo: Empleo presencial
