Så skriver du ett mermaid-sekvensdiagram

Det minsta som behövs

Deklarera diagramtypen, skriv sedan en rad per meddelande. Deltagare skapas vid första omnämnandet, i den ordning de dyker upp.

sequenceDiagram
  User->>API: POST /orders
  API->>DB: INSERT order
  DB-->>API: order id
  API-->>User: 201 Created

💡Deklarera deltagare explicit med participant User när du vill ha en specifik vänster-till-höger-ordning istället för ordningen de först nämns i.

Piltyper

Konventionen värd att behålla: heldragen för anropet, streckad för returen. En läsare kan då avgöra en förfrågan från ett svar utan att läsa en enda etikett.

Deltagare och alias

sequenceDiagram
  participant U as Browser
  participant A as API gateway
  participant S as Order service
  U->>A: GET /orders
  A->>S: list(userId)
  S-->>A: orders
  A-->>U: 200 OK

Använd actor U as Browser istället för participant för att rita en streckgubbe — värt det för personen i vänsterkanten av ett autentiseringsflöde.

Aktiveringsstaplar

Aktiveringsstaplar visar hur länge en deltagare är upptagen. Markera dem antingen explicit med activate/deactivate, eller lägg till + och - på pilarna, vilket är kortare och svårare att få i obalans.

sequenceDiagram
  User->>+API: POST /pay
  API->>+Bank: charge
  Bank-->>-API: authorised
  API-->>-User: receipt

Loopar, villkor och parallellt arbete

sequenceDiagram
  User->>API: POST /import
  loop every row
    API->>DB: upsert row
  end
  alt all rows valid
    API-->>User: 200 OK
  else some failed
    API-->>User: 422 with errors
  end
  par notify
    API->>Email: send summary
  and audit
    API->>Log: write entry
  end

• loop <label> … end — upprepning.
• alt <label> … else <label> … end — ömsesidigt uteslutande grenar.
• opt <label> … end — en gren som kanske helt enkelt inte inträffar.
• par <label> … and <label> … end — saker som händer samtidigt.
• critical / break — ett avsnitt som inte får avbrytas, och en tidig utgång.

Anteckningar

sequenceDiagram
  User->>API: POST /login
  Note right of API: Rate limited<br>5 per minute
  API-->>User: token
  Note over User,API: Token is valid for 30 days

Note over A,B spänner över två deltagare och är rätt plats för ett villkor som hör till interaktionen snarare än till någon av sidorna.

Ett fullständigt exempel

sequenceDiagram
  actor U as User
  participant A as App
  participant P as Provider
  U->>+A: Click "Sign in"
  A-->>-U: Redirect to provider
  U->>+P: Authorise
  P-->>-U: Redirect back with code
  U->>+A: GET /callback?code=…
  A->>+P: Exchange code for token
  P-->>-A: access token
  Note right of A: Session cookie set here
  A-->>-U: Signed in