Intégrer Didit : API, SDK et webhooks

Transcription complète de Intégrez Didit dans votre application : API, SDK et webhooks (guide développeur) - Didit Academy, vidéo 8 sur 10, 08:13. Voir sur YouTube. Chaque paragraphe renvoie au moment exact de la vidéo.

​

Ce que vous allez mettre en place

00:04 Dans cette vidéo, vous allez intégrer Didit dans votre propre application. Ainsi, vos utilisateurs se vérifient directement dans votre produit, et chaque résultat remonte dans votre système au moment où il se produit. Cette vidéo s’adresse aux développeurs, elle est donc un peu plus technique, mais elle est plus simple que vous ne le pensez. Et à la fin, vous verrez que vous pouvez confier l’essentiel à Cloud Code et lui demander de le construire à votre place. Nous allons donc tout parcourir dans l’ordre

​

SDK, API et webhook : les trois éléments

00:28 où vous le construiriez réellement. Entrons directement dans le vif du sujet. Intégrer Didit revient à mettre en place trois éléments. Le SDK affiche directement dans votre application l’interface de la caméra, la capture du document, la lecture NFC et l’interface de détection du vivant. L’API fonctionne de serveur à serveur : votre back end crée la session et lit la décision qui fait foi. Le webhook appelle votre endpoint HTTPS dès qu’une session change d’état, ce qui est bien

​

L’onglet Integrate

00:56 plus rapide et plus riche que l’interrogation répétée pour obtenir ce résultat. La façon la plus simple d’intégrer consiste donc à aller dans votre onglet Manage, à cliquer sur Integrate, et nous pouvons récupérer tous les paramètres ici même, notamment notre clé API. Nous pouvons ainsi configurer une clé API spécifique pour l’application sur laquelle nous travaillons. Nous pouvons créer et choisir un workflow à intégrer. Nous pouvons ajouter un webhook. C’est là que les résultats de vérification sont envoyés. 01:24 Et le secret de signature, que je vous montrerai dans un instant, c’est ce qui doit aller dans votre fichier ENV.

​

Choisir votre plateforme

01:28 Vous pouvez ensuite le connecter à votre application. Plusieurs options s’offrent à vous : web JS, React Native, iOS, Android, Flutter, et quelques autres plateformes. Vous sélectionnez celle qui correspond à votre application. Il s’agit des secrets d’environnement que vous allez placer dans votre fichier ENV, sur votre

​

Le prompt de configuration IA

01:48 serveur. Le plus simple est donc d’utiliser le prompt de configuration IA. Nous configurons tous les paramètres ici, puis nous copions le prompt, qui reprend toutes les informations pertinentes issues de la configuration que nous venons de faire. Nous le copions et le collons dans Cloud Code ou Codex, ou dans l’outil de votre choix pour

​

Clés API : une par environnement

02:09 construire votre application. Vos clés API se trouvent ici, et chaque ligne correspond à une clé, d’accord ? Une bonne habitude consiste donc à utiliser une clé distincte par environnement et par intégration. Ainsi, vous pouvez renouveler ou révoquer une clé sans affecter les autres. Donc, si vous voulez intégrer un workflow précis, vous

​

Créer une clé

02:27 pouvez vouloir créer une clé API distincte pour ce workflow, par exemple. Maintenant, si je clique sur Créer une clé API, euh, je vais simplement saisir test ici, puis créer la clé API. Je peux maintenant la copier, n’est-ce pas ? Et je ne la reverrai pas. Il est donc important de la copier et de la noter quelque part, pour pouvoir l’utiliser lors de l’intégration. Quand on arrive dans la section d’intégration et qu’on récupère sa clé API, par exemple la clé test, je la sélectionne, puis je choisis le workflow KYC que nous voulons utiliser. Nous pouvons ajouter un webhook. 03:05 Nous pouvons connecter notre application, d’accord. Puis nous pouvons coller ici ce prompt de configuration. Vous voyez ici que ce prompt va

​

Vue d’ensemble des webhooks

03:13 inclure la clé API. Passons rapidement aux webhooks : nous pouvons en configurer un pour à peu près tout ce que nous voulons. Par exemple, si vous voulez envoyer un événement précis vers Slack, n’est-ce pas ? Nous pouvons

​

La documentation

03:25 ajouter ici l’URL du webhook. D’accord, regardons un peu la documentation, car vous avez accès à toute la documentation technique. Il suffit d’aller sur docs.didit.me, et nous allons examiner quelques points

​

Create session : le seul champ obligatoire

03:37 ici. Tout tourne autour de create session. Il s’agit d’une requête POST, le point de départ d’une vérification. On voit ici, dans la requête curl, le workflow ID. C’est le seul champ obligatoire, et le plus utile est que ce même endpoint crée aussi bien des sessions KYC que KYB. Le

​

Vendor data et URL de rappel

04:00 workflow détermine de quel type de session il s’agit. Nous avons ensuite quelques champs supplémentaires plus bas, dont vendor data, dont nous avons beaucoup parlé dans ces vidéos. Il s’agit de l’identifiant unique de chaque utilisateur, que vous définissez comme vous le souhaitez, une adresse e-mail ou un autre identifiant unique. Puis il y a l’URL de rappel. C’est vers elle que l’utilisateur est renvoyé une fois le parcours de vérification terminé. Donc,

​

Essayer l’endpoint en direct

04:24 si nous descendons ici, nous pouvons l’essayer concrètement. Si nous cliquons sur try it, nous pouvons créer une session de vérification. Je vais simplement saisir une des clés API ici. Je vais en créer une toute nouvelle, test two. Je la copie, puis je la colle ici. Nous voulons récupérer un workflow ID. Revenons ici. Nous pouvons prendre ce workflow ID et le saisir là. Le vendor data n’est pas obligatoire. Mettons simplement une suite de chiffres au hasard. 05:02 Pour le callback, nous pouvons le garder tel quel. Rien de tout cela n’est obligatoire, d’ailleurs. Je pense que c’est parce que j’ai ici un compte de test, mais si vous voulez tester cet endpoint, c’est exactement la marche à suivre. Maintenant, si vous êtes développeur et que vous voulez des réponses précises, vous pouvez consulter la documentation. Le MCP a aussi accès à toute cette documentation : vous pouvez donc simplement intégrer le MCP et poser à Claude une question technique dont la réponse se trouve probablement dans ces documents.

​

Webhooks, pourquoi pas le polling

05:32 Dans cet écran, parlons des webhooks. Un onglet dédié aux webhooks se trouve dans la section Manage, et c’est ainsi que vos résultats vous parviennent réellement. Les webhooks sont le canal recommandé, car le polling est assez lent, et il

​

Ajouter une destination et sélectionner des événements

05:44 vous coûtera davantage de requêtes, et il fera passer des événements à la trappe. Ajoutez donc une nouvelle destination ici. Vous pouvez coller une URL et choisir les événements souhaités. Ce sont toutes les données que nous voulons envoyer à cet endpoint. Didit vous remet alors un secret de signature fourni une seule fois, que je vous montrerai dans un instant. L’URL doit être directement accessible : pas de localhost, ni d’adresses IP privées. Je quitte donc cet écran et défile vers le côté droit, où plusieurs options sont disponibles. 06:16 Nous voyons ici le nombre d’événements auxquels ce webhook est abonné, et nous pouvons

​

Le secret de signature

06:19 copier le secret de signature, qui sera important pour votre intégration. Lorsque vous configurez l’intégration dans l’onglet Intégrations, comme je vous l’ai expliqué, une invite apparaît, et le secret de signature du webhook que vous avez sélectionné lors de la configuration s’y trouve. Donc,

​

Le prompt du gestionnaire de webhooks

06:34 une autre façon de tirer parti de l’IA : nous disposons d’un prompt prêt à l’emploi, que j’ai trouvé dans l’onglet Webhooks. Vous pouvez demander à l’IA de configurer notre gestionnaire de webhooks. Consultez la documentation et vous y trouverez un prompt d’intégration. Il couvre la vérification d’identité, l’entité et les transactions, et construit l’ensemble pour vous. Il détaille tout : ce qu’il faut créer, les en-têtes de signature à utiliser pour la vérification, les types d’événements webhook que vous venez de voir lors de la configuration d’un webhook, l’enveloppe du webhook et bien d’autres éléments. Vous pouvez aussi choisir l’outil dans lequel le coller. 07:15 Si vous voulez utiliser ce prompt, c’est la façon la plus simple de démarrer et de mettre vos intégrations en place. Tout ce que je viens de présenter dans cette vidéo est accessible et interrogeable depuis votre outil d’IA si vous intégrez le serveur MCP. Vous pouvez donc décrire en anglais courant ce que vous voulez obtenir, et Cloud Code lira la documentation et construira l’intégration pour vous. Vous n’avez plus qu’à vérifier le travail, à vous assurer que tout est en cours d’exécution et

​

Récapitulatif

07:41 fonctionne, plutôt que de tout coder à partir de zéro. Voilà Didit dans votre application : le SDK que voient vos utilisateurs, l’API que votre back-end appelle et le webhook signé qui transmet le verdict sur lequel vous vous appuyez. Faites confiance au webhook, utilisez partout les données du fournisseur et appuyez-vous sur le prompt de configuration pour ne pas câbler à la main les parties répétitives. Rendez-vous sur didit.me, inscrivez-vous gratuitement, et vous pourrez lancer une vérification en quelques minutes.