Aller au contenu principal
NEXCLARADocumentation

account

Le contrat ne décrit pas cette famille.

Les descriptions viennent du contrat, rédigé en français. Elles sont reproduites telles quelles pour rester la source de vérité.

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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
RecoveryCompleteIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
InvitationTokenIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
InvitationTokenIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
PasswordChangeIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
ProfileIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Type de contenu
application/json
Type
SecondFactorCodeIn
Requis
oui

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Aucun corps de requête.

Réponses

StatutDescriptionType de contenuType
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

Paramètres

ParamètreEmplacementTypeRequisContraintes
limitqueryintegernonminimum: 1 ; maximum: 100 ; default: 50

Corps de la requête

Aucun corps de requête.

Réponses

StatutDescriptionType de contenuType
200Successful Responseapplication/jsonarray<SecurityEventOut>
422Validation Errorapplication/jsonHTTPValidationError

GET /api/v1/me/sessions

Ses sessions ouvertes

Sessions ouvertes de l'appelant, la courante designee.

meListSessions

Paramètres

Aucun paramètre.

Corps de la requête

Aucun corps de requête.

Réponses

StatutDescriptionType de contenuType
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

Paramètres

Aucun paramètre.

Corps de la requête

Aucun corps de requête.

Réponses

StatutDescriptionType de contenuType
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

Paramètres

ParamètreEmplacementTypeRequisContraintes
session_idpathstring (uuid)oui

Corps de la requête

Aucun corps de requête.

Réponses

StatutDescriptionType de contenuType
204Successful Response—
422Validation Errorapplication/jsonHTTPValidationError