Générer un lien de connexion à l'espace candidat

Certiplace vous permet de générer un lien de connexion magique pour un dossier de certification, afin que le candidat accède directement à son espace personnel sur ce dossier, sans avoir à créer de mot de passe.

Le lien est généré par l'organisme certificateur propriétaire du dossier, puis transmis au candidat par le canal de votre choix (email, SMS…).

Prérequis

Être connecté à Certiplace avec un compte ayant les droits d'édition sur le dossier
Être l'organisme certificateur propriétaire du dossier de certification

Si vous n'êtes pas autorisé sur le dossier, la génération est refusée (« Erreur, vous n'êtes pas autorisé à générer un lien de connexion pour ce dossier. »)

Génération du lien

Endpoint : POST /api/certificationFolders/{externalId}/generateAttendeeMagicLink

Le lien retourné connecte le candidat puis le redirige vers son espace sur le dossier indiqué (/candidat-{externalId} ).

Rediriger vers un document précis (optionnel)

Vous pouvez faire en sorte que le candidat arrive directement sur un document du dossier après connexion, plutôt que sur l'accueil de son espace.

Pour cela, ajoutez le champ fileId dans le corps de la requête :

json { "fileId": 1234 }

fileId est l'identifiant du document du dossier concerné. Le candidat est alors redirigé directement vers ce document après s'être connecté.

Note : si le fileId fourni ne correspond à aucun document de ce dossier, la requête échoue avec une erreur (« Le document associé à l'id … n'a pas été trouvé pour ce dossier. »)

Le champ fileId est facultatif. Sans lui, le lien redirige vers l'accueil de l'espace du dossier

Réponse

En cas de succès, l'endpoint renvoie un JSON contenant l'URL du lien de connexion à transmettre :

json { "url": "https://www.wedof.fr/auth/magic-link-auth?..." }

Cette URL est à transmettre au candidat par le canal de votre choix.

Traçabilité

Note : chaque génération de lien est tracée dans l'historique du dossier sous forme d'activité de type « connexion » (« Un lien de connexion à l'espace candidat a été généré »).