Démarrage automatique

Vous trouvez ici comment lancer l’application ExcelID quand elle est installée sur l’appareil qui sert à visiter votre application ou votre page web. L’application est lancée par un lien (« autostart »). La méthode varie légèrement selon la plateforme du client. Pour un aperçu des cas d’usage les plus courants, voir Même appareil.

Paramètres

token string Obligatoire

Contient l’autoStartToken renvoyé par l’appel à /auth ou /sign.

L’adresse de retour n’est pas un paramètre du lien : vous l’envoyez côté backend à la création de la demande, avec returnUrl (voir URL de retour).

Le lien

excelid://autostart?token=[TOKEN]

Application native sur mobile

Android

Si votre client est une application Android, lancez ExcelID avec le lien.

val intent = Intent(Intent.ACTION_VIEW).apply {
    data = Uri.parse("excelid://autostart?token=$autoStartToken")
}
try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // ExcelID n'est pas installé : informez l'utilisateur (message EM2)
}

Si l’application n’est pas présente, une ActivityNotFoundException est levée. Informez alors l’utilisateur qu’il lui faut ExcelID. Un résultat valide n’est pas garanti en retour : votre application doit s’appuyer sur l’appel à /collect pour connaître le résultat.

Lancement depuis un navigateur

Si votre frontend est une page web, lancez ExcelID avec le lien. Vérifiez d’abord si le navigateur tourne sur un mobile ou sur un ordinateur.

Appareil mobile

const link = document.createElement('a');
link.href = `excelid://autostart?token=${autoStartToken}`;
link.click();

Si l’application ne s’ouvre pas dans les secondes qui suivent, proposez les solutions de secours.

Ordinateur

ExcelID est une application mobile : sur ordinateur, ne tentez pas le lancement automatique. Affichez le code QR animé pour que l’utilisateur le scanne avec son téléphone.