Skip to main content

Module magic_link_handlers

Module magic_link_handlers 

Source
Expand description

HTTP handlers for the MagicLink feature (Story 3.2).

Two endpoints:

  • POST /magic-links — syndic / superadmin issues a link for a recipient.
  • GET /c/{token} — PUBLIC: validate, consume, resolve scope. The route is intentionally outside /api/v1 so the public-facing URL stays short (/c/<token>). IP-based rate-limiting is enforced by Traefik for all routes — no extra guard needed here.

Structs§

IssueMagicLinkRequest
IssueMagicLinkResponse
PublicScopePayload
consume_magic_link
issue_magic_link
respond_magic_link
Only ContractorReport has a real “respond” action today: view the ticket via the other four scopes is already implemented (GET /c/{token}), but writing back for them has no use case yet — that’s an existing gap this route doesn’t attempt to close, only to name explicitly rather than 404.