Mensajes entre actores en el tiempo, con retornos, llamadas asíncronas y ramas.
1 ejemplo de diagrama de secuencia
Secuencia de un pago con tarjeta
Una petición de compra que pasa por la web, la API de pagos y el banco, con la rama de rechazo.
El tiempo baja por las líneas de vida. Las flechas continuas son llamadas, las discontinuas son retornos, y el marco alt contiene los dos resultados de la autorización. El acento va en un solo mensaje: el 201 de éxito.
Un diagrama de secuencia UML muestra cómo interactúan varios participantes mediante mensajes ordenados en el tiempo. Cada actor o sistema tiene una línea de vida vertical y el tiempo avanza hacia abajo.
Las flechas continuas son llamadas, las discontinuas son respuestas y las de punta abierta, mensajes asíncronos. Los marcos alt, opt y loop agrupan ramas condicionales y repeticiones, y las barras sobre la línea de vida indican cuándo un participante está activo.
Cuándo usar un diagrama de secuencia
Para documentar un pago con tarjeta entre cliente, comercio, pasarela y banco, incluido qué pasa si se deniega.
Para diseñar una integración de API y acordar con otro equipo qué llamadas, en qué orden y con qué respuestas.
Si quieres mostrar qué componentes existen y cómo se conectan, sin el orden temporal, usa un diagrama de arquitectura.
Cómo hacer un buen diagrama de secuencia
Ordena los participantes de izquierda a derecha según intervienen, con el iniciador en el extremo izquierdo.
Etiqueta cada mensaje con la operación real (POST /payments, autorizar) y, si aporta, los datos clave.
Representa los errores y los tiempos de espera con marcos alt; el camino feliz solo cuenta la mitad.
Céntrate en un escenario por diagrama; si se alarga mucho, divídelo por casos.
