Confirmer la méthode d’authentification

Confirmer l’inscription d’une méthode d’authentification prise en charge.

POST https://{host}/me/v1/authentication-methods/{authentication_method_id}/verify

cURL

email

curl --request POST \
  --url https://{host}/me/v1/authentication-methods/{authentication_method_id}/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "auth_session": "Fe26.2**05c400ed...",
  "otp_code": "123456"
}
'

201

email

{
  "confirmed": true,
  "created_at": "2025-01-15T10:30:00.000Z",
  "email": "[e-mail]",
  "id": "email|dev_XXXXXXXXXXXXXXXX",
  "type": "email",
  "usage": [
    "secondary"
  ]
}

Autorisations

Authorization · string · header · requis

Les jetons Bearer et DPoP sont pris en charge selon la configuration de l’API

Paramètres de chemin

authentication_method_id · string · requis

ID de la méthode d’authentification. Cette valeur fait partie de l’en-tête Location renvoyé lors de la création d’une méthode d’authentification. Elle doit être utilisée telle quelle, sans aucune modification.

Corps

application/json

Passkey verification payload

Password verification payload

WebAuthn Platform verification payload

WebAuthn Roaming verification payload

Push Notification verification payload

Recovery Code verification payload

Email verification payload

Phone verification payload

TOTP verification payload

Contenu de la requête pour vérifier une méthode d’authentification

auth_session · string · requis

L’identifiant de session unique de l’inscription, tel que renvoyé par POST /authentication-methods

authn_response · object · requis

Show child attributes

Réponse

201

application/json

Méthode d’authentification vérifiée

password

passkey

recovery-code

push-notification

totp

webauthn-platform

webauthn-roaming

phone

email

created_at · string<date-time> · requis

La date et l’heure de création de la méthode d’authentification

id · string · requis

L’identifiant unique de la méthode d’authentification

usage · enum<string>[] · requis

Facteur principal et/ou secondaire

Type d’utilisation des facteurs d’authentification

Options disponibles: primary, secondary

identity_user_id · string · requis

L’ID de l’identité utilisateur liée à la méthode d’authentification

type · string · défaut: password · requis

Type de méthode d’authentification (facteur)

Allowed value: "password"

last_password_reset · string<date-time>

La date de la dernière réinitialisation du mot de passe