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-doorverwijzing

Voorbeeld-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

Gerelateerde artikelen

← Authenticatie