API-documentatie

Eerste referentie als OpenAPI (YAML): account-login, context, onboarding, workspaces, organisatieportfolio onder het account en organisatieportaal-auth. Verdere domeinen worden gefaseerd toegevoegd.

OpenAPI-specificatie (fase 1)

Machineleesbare beschrijving van de nu uitgewerkte paden. Geschikt om te importeren in Postman, Stoplight of codegeneratie.

openapi.yaml openen of downloaden

API- en integratievoorwaardenjuridisch kader voor gebruik van de API en integraties (aanvullend op de algemene voorwaarden).

Account-SPA: authenticatie, context, bootstrap

Stateful sessie (guard account_web): login en 2FA, logout, gebruikersinfo, actieve context, sessie-bootstrap en workspace-switch-callback.

  • POST /api/auth/login
  • POST /api/auth/login/two-factor
  • POST /api/auth/logout
  • GET /api/auth/me
  • GET /api/auth/post-login
  • GET /api/auth/contexts
  • POST /api/auth/context
  • DELETE /api/auth/context
  • GET /api/auth/bootstrap
  • POST /api/auth/switch-callback

Onboarding

Signup, status, plankeuze en afronden — zoals in routes/account.php en de OpenAPI-tag onboarding.

  • POST /api/onboarding/signup
  • GET /api/onboarding/status
  • POST /api/onboarding/plan
  • POST /api/onboarding/complete

Workspaces

Lijst en aanmaken van workspaces, slug-controle, switch-token en kiezen van de actieve workspace.

  • GET /api/workspaces
  • POST /api/workspaces
  • GET /api/workspaces/slug-available
  • POST /api/workspaces/switch-token
  • POST /api/workspaces/select

Organisatieportfolio (account)

Organisatie-bootstrap, lidmaatschappen en dashboard-GET onder /api/org — met account_web en portfolio-middleware.

  • POST /api/org
  • GET /api/org/memberships
  • GET /api/org/{organization}

Organisatieportaal

Aparte sessie (guard organisation_web): login, logout, me en bootstrap na de organisatie-2FA-middleware.

  • POST /api/organisation-app/login
  • POST /api/organisation-app/logout
  • GET /api/organisation-app/me
  • GET /api/organisation-app/bootstrap