API Reference
OTP Generate (Portal)

OTP Generate (Portal)

Génère un code OTP pour un identifiant donné dans le contexte du portail.

Méthode : POST

URL : /api/v1/esphere/portal/otp-generate

Authentification : Basic Auth requise

Requête

Headers

NomValeurDescription
Content-Typeapplication/jsonFormat du corps de la requête
AuthorizationBasic <base64(credentials)>Authentification de base

Body Parameters

NomTypeRequisDescription
project_keystringOuiClé du projet
e_identifierstringOuiIdentifiant électronique (ex: email, téléphone)
titlestringNonTitre associé
modestringNonMode de génération ('1' = Code à 6 chiffres; '2' = QR Code)
redirection_urlstringNonURL de redirection après validation
expiration_timeintegerNonTemps d'expiration en minutes (ex: 2)

Exemple de requête

{
  "project_key": "string",
  "e_identifier": "string",
  "title": "string",
  "mode": "1",
  "redirection_url": "string",
  "expiration_time": 2
}

Réponses

200 Success

Le code OTP a été généré avec succès.

Content-Type: application/json

NomDescription
portal_urlUrl du portail pour la session
{
  "portal_url": "string"
}

Erreurs typiques

Code d'erreurPayloadMessage d'erreurDescription
ERROR_CODE_BAD_REQUEST4001Projet invalide.Clé projet incorrecte ou invalide
ERROR_CODE_BAD_REQUEST4002Compte e invalide.Compte e@ incorrecte ou invalide

Erreurs standards

400 Input Error

Erreur dans les données d'entrée. Vérifiez le corps de la requête.

401 Unauthorized

Non autorisé.

403 Access Denied

Accès refusé. Des privilèges supplémentaires sont nécessaires.

404 Not Found

La ressource demandée n'existe pas.

429 Rate Limited

Trop de requêtes.

500 Unexpected Error

Erreur inattendue du serveur.