Liens de vérification réutilisables

Un lien pérenne par workflow qui démarre une nouvelle session à chaque visite, idéal pour un bouton de site web, un code QR, ou des affiliés. Ajoutez votre propre référence avec vendor_data.

Short answer

Chaque workflow dispose d'un lien réutilisable qui crée une nouvelle session par visiteur. Placez-le derrière un bouton, imprimez-le sous forme de code QR, ou remettez-le à des partenaires. Ajoutez votre propre identifiant en tant que ?vendor_data= pour pouvoir distinguer à qui appartient chaque session.

#Un lien, plusieurs personnes

Un lien de vérification à usage unique appartient à une seule personne. Un lien réutilisable appartient au workflow : chaque visite démarre une nouvelle session, donc vous pouvez publier une seule URL et laisser un nombre illimité de personnes se vérifier à travers elle.

La liste des workflows dans la console Didit avec l'action Copy link sur une ligne de workflow
  1. Copy link vous donne une URL que n'importe qui peut ouvrir, sans appel API nécessaire.
  2. Le lien exécute tout ce que ce workflow contient, donc vérifiez d'abord ses fonctionnalités.
  3. Un workflow distinct donne un lien distinct, ce qui permet de différencier les campagnes.
Un lien réutilisable est à une action de distance de n'importe quel workflow.

Cas d'usage adaptés :

  • Un bouton "Vérifiez votre identité" sur votre site web
  • Un code QR imprimé dans une agence, un kiosque, ou un événement
  • Un lien remis à des affiliés, des partenaires, ou des revendeurs
  • Toute situation où vous ne savez pas à l'avance qui l'utilisera

#Distinguer les sessions entre elles

Le problème évident d'un lien partagé est que chaque session qui en résulte semble anonyme. Résolvez-le en ajoutant votre propre référence :

https://verify.didit.me/<your-link>?vendor_data=YOUR_INTERNAL_ID

Tout ce que vous transmettez comme vendor_data revient sur la session et sur chaque webhook, donc vous pouvez faire correspondre le résultat au bon enregistrement de votre côté sans table de correspondance.

Tip

Générez la valeur par utilisateur : votre propre identifiant utilisateur, ou un jeton signé que vous pouvez résoudre. Cela permet aussi à la détection de doublons de fonctionner correctement : les sessions partageant un vendor_data sont regroupées en un seul utilisateur consolidé, donc un client qui revient n'est pas signalé comme son propre doublon. Voir comptes en double et recherche faciale.

Si vous générez la valeur dynamiquement pour chaque visiteur, générez le lien entier côté serveur. Un vendor_data qu'un utilisateur peut modifier dans la barre d'adresse est un vendor_data dans lequel un utilisateur peut mettre l'identifiant de quelqu'un d'autre.

#Ce qu'un lien réutilisable ne vous donne pas

  • Pas d'expiration par personne. Un lien de session à usage unique peut expirer ; un lien réutilisable est censé rester actif. Si vous avez besoin d'un lien qui expire pour une personne précise, créez une session unique à la place.
  • Pas de détails attendus pré-remplis. Quand vous créez une session via l'API, vous pouvez transmettre un nom ou un numéro de document à comparer. Un lien partagé n'a aucun contexte par personne, donc ces comparaisons ne sont pas disponibles.
  • Pas de contrôle sur qui l'utilise. Un lien réutilisable est une URL publique. Quiconque le possède peut démarrer une session, ce qui convient pour un bouton de site web et convient moins pour quelque chose que vous vouliez réserver à une seule personne.

#Cela coûte toujours ce que coûte le workflow

Chaque visite via un lien réutilisable est une session complète contre ce workflow, facturée de la même façon. Un lien partagé plus largement que prévu donne une facture plus élevée que prévu, donc si vous en publiez un quelque part de public, gardez un œil sur le volume dans Analytics. Voir lire vos analyses.

#Quel workflow il utilise

Le lien est associé à un workflow spécifique dans une application spécifique, donc il exécute toujours la version publiée actuelle de ce workflow. Modifier le workflow change ce que reçoivent les nouveaux visiteurs : les sessions déjà en cours conservent la version avec laquelle elles ont démarré.

#Récupérer les résultats

Comme partout ailleurs : surveillez la console, ou récupérez les résultats par webhook. Comme les sessions arrivent de façon imprévisible plutôt qu'en réponse à vos propres appels API, un webhook est nettement plus utile ici que l'interrogation périodique : vous n'avez rien à interroger tant qu'une session n'existe pas.

#Référence complète

Voir liens de vérification et liens réutilisables pour le guide dans la console.