Examples in

Vérification du téléphone

Un numéro de téléphone vérifié peut servir de second facteur de secours et de canal de récupération dans le cas rare où un utilisateur a perdu à la fois son mot de passe et son appareil TOTP/WebAuthn. La vérification suit le processus classique « nous envoyons un code par SMS, vous le saisissez ».

Le SMS comme facteur 2FA principal est plus faible que TOTP ou WebAuthn (attaques par SIM swap, failles de SS7). NimbusNexus prend en charge la 2FA par SMS mais utilise TOTP par défaut pour tout nouvel enrôlement ; pour les comptes de niveau Production, le SMS n’est proposé que comme voie de récupération. Les comptes Enterprise peuvent désactiver complètement le SMS si leur modèle de menace l’exclut.

Étapes suivantes

Authentification à deux facteurs — la configuration principale de la 2FA.
Utilisateurs — la ressource à laquelle sont rattachés les numéros de téléphone.

Reference

GET/api/v1/phone/

Retrieve Phone

Return the verified phone number on file for the current user, if any.

Responses

200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/phone/" \
  -H "Authorization: Bearer $NIMBUS_KEY"

POST/api/v1/phone/

Add Phone

Stage a phone number for the current user and send a one-time SMS verification code to it.

Request body

Field	Type	Description
phone_code*	string	—
phone_number*	string	—

Responses

200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/phone/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_code": "example",
    "phone_number": "example"
  }'

DELETE/api/v1/phone/

Delete Phone

Remove the current user's verified phone number and disable two-factor authentication.

Responses

204Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/phone/" \
  -H "Authorization: Bearer $NIMBUS_KEY"

POST/api/v1/phone/phone_passcode_validation

Phone Passcode Validation

Validate the SMS passcode and promote the staged phone number to verified.

Request body

Field	Type	Description
passcode*	string	—

Responses

200Successful Response
400Bad Request
401Unauthorized
403Forbidden
404Not Found
409Conflict
422Validation error
429Too Many Requests
500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/phone/phone_passcode_validation" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "passcode": "example"
  }'

Need to make a real call? Try these endpoints in the live Swagger UI →

Edit this page on GitHub