Skip to main content
NEXCLARADocumentation

account

The contract does not describe this family.

Descriptions come from the contract, which is written in French. They are reproduced verbatim so that the contract remains the source of truth.

POST /api/v1/account-recovery/complete

Achever un retablissement

Preuve du facteur restant puis remplacement de l'autre ; toutes les sessions ferment. Une preuve fausse compte comme un echec de connexion.

accountRecoveryComplete

Parameters

No parameters.

Request body

Content type
application/json
Type
RecoveryCompleteIn
Required
yes

Responses

StatusDescriptionContent typeType
204Successful Response—
422Validation Errorapplication/jsonHTTPValidationError

POST /api/v1/account-recovery/enrollment

Enroler la nouvelle cle d'un lien `second_factor`

Cle TOTP a enroler, montree une seule fois.

accountRecoveryEnrollment

Parameters

No parameters.

Request body

Content type
application/json
Type
InvitationTokenIn
Required
yes

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonEnrollmentOut
422Validation Errorapplication/jsonHTTPValidationError

POST /api/v1/account-recovery/inspect

Inspecter un lien de retablissement

Ce que le detenteur d'un lien valide peut savoir de son lien.

accountRecoveryInspect

Parameters

No parameters.

Request body

Content type
application/json
Type
InvitationTokenIn
Required
yes

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonRecoveryInspectionOut
422Validation Errorapplication/jsonHTTPValidationError

POST /api/v1/me/password

Changer son mot de passe

Exige le mot de passe actuel et une authentification renforcee recente. Un mot de passe actuel faux compte comme un echec de connexion. Les autres sessions sont fermees.

meChangePassword

Parameters

No parameters.

Request body

Content type
application/json
Type
PasswordChangeIn
Required
yes

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonSessionsRevokedOut
422Validation Errorapplication/jsonHTTPValidationError

PUT /api/v1/me/profile

Modifier sa presentation

Nom affiche, fonction et langue de l'appelant. La fonction ne donne aucun droit ; les roles ne se modifient jamais ici.

meUpdateProfile

Parameters

No parameters.

Request body

Content type
application/json
Type
ProfileIn
Required
yes

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonUserOut
422Validation Errorapplication/jsonHTTPValidationError

POST /api/v1/me/second-factor/confirmation

Prouver la nouvelle cle et la mettre en service

Un code valide de la nouvelle cle la met en service ; autres sessions fermees.

meConfirmSecondFactor

Parameters

No parameters.

Request body

Content type
application/json
Type
SecondFactorCodeIn
Required
yes

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonSessionsRevokedOut
422Validation Errorapplication/jsonHTTPValidationError

POST /api/v1/me/second-factor/enrollment

Enroler une nouvelle cle de second facteur

Exige une authentification renforcee recente. La nouvelle cle reste en attente ; l'ancienne reste en service tant que la nouvelle n'est pas prouvee.

meBeginSecondFactor

Parameters

No parameters.

Request body

No request body.

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonSecondFactorEnrollmentOut

GET /api/v1/me/security-events

Historique de connexion et de securite

Lu dans la chaine d'audit : connexions, echecs, verrouillages, changements de facteur, retablissements, deconnexions forcees. Aucune adresse IP n'est recueillie.

meListSecurityEvents

Parameters

ParameterLocationTypeRequiredConstraints
limitqueryintegernominimum: 1 ; maximum: 100 ; default: 50

Request body

No request body.

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonarray<SecurityEventOut>
422Validation Errorapplication/jsonHTTPValidationError

GET /api/v1/me/sessions

Ses sessions ouvertes

Sessions ouvertes de l'appelant, la courante designee.

meListSessions

Parameters

No parameters.

Request body

No request body.

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonarray<OwnSessionOut>

POST /api/v1/me/sessions/revoke-others

Fermer toutes ses autres sessions

Ferme toutes les sessions de l'appelant sauf la courante.

meRevokeOtherSessions

Parameters

No parameters.

Request body

No request body.

Responses

StatusDescriptionContent typeType
200Successful Responseapplication/jsonSessionsRevokedOut

POST /api/v1/me/sessions/{session_id}/revoke

Fermer une de ses sessions

La session courante se ferme par la deconnexion (`SESSION_IS_CURRENT`).

meRevokeSession

Parameters

ParameterLocationTypeRequiredConstraints
session_idpathstring (uuid)yes

Request body

No request body.

Responses

StatusDescriptionContent typeType
204Successful Response—
422Validation Errorapplication/jsonHTTPValidationError