POST/api/auth/sso/exchange
Laatste stap van een SSO-aanmelding (SAML/OIDC): wisselt de eenmalige code uit de doorverwijzing in voor een toegangstoken en een refresh token.
Na het aanmelden bij de identity provider stuurt Zentor App de browser terug met een eenmalige code in de queryparameter `sso_code`. Stuur deze code in het veld `code`. Het antwoord bevat `token` en `refreshToken`, net als bij een gewone aanmelding. Elke code is maar één keer en slechts kort geldig. Een al gebruikte, verlopen of ongeldige code resulteert in 400 `SSO_EXCHANGE_INVALID`; de gebruiker start de SSO-aanmelding dan opnieuw. De aanroep is daarom niet idempotent.
Overzicht
Aanroep: POST /api/auth/sso/exchange. Dit endpoint hoort bij de groep ‘Authenticatie’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: code (body). Gedocumenteerde foutgevallen: 400 SSO_EXCHANGE_INVALID. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.
Auth & beveiliging
Geen authenticatie vereist
Idempotent: Nee
Parameters
code(body, string, vereist)— Eenmalige code uit de SSO-doorverwijzingVoorbeeld-request
{"code":"<eenmalige code uit de SSO-callback-redirect>"}Voorbeeld-response
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Foutcodes
400 SSO_EXCHANGE_INVALID — De code is ongeldig, al gebruikt of verlopen.Geverifieerd gedrag
Een ongeldige code levert 400 `SSO_EXCHANGE_INVALID` op. Het succesgeval vereist een volledige aanmelding bij de ingerichte identity provider.
Authenticatie
POST /api/auth/loginMeldt een gebruiker aan met e-mailadres of gebruikersnaam en wachtwoord en geeft een toegangstoken (JWT) en een refresh token uit.POST /api/auth/refreshWisselt een geldig refresh token in voor een nieuw paar toegangstoken en refresh token.POST /api/auth/forgot-passwordStart het resetten van een wachtwoord: bestaat er een account met het opgegeven e-mailadres, dan ontvangt dit een e-mail met een resetlink.POST /api/auth/reset-passwordStelt een nieuw wachtwoord in met het resettoken uit de resetmail.