Clients API Idempotents pour une Vérification d'Identité Fiable (FR)

Assurer la cohérence des donnéesImplémentez des appels API idempotents pour garantir que les requêtes répétées de vérification d'identité n'entraînent pas de résultats multiples, contradictoires ou erronés, en maintenant l'intégrité des données.

Atténuer les problèmes de réseauConcevez votre client pour gérer gracieusement les défaillances réseau transitoires en relançant les opérations en toute sécurité sans effets secondaires indésirables, améliorant ainsi la résilience du système.

Prévenir les actions en doubleUtilisez des clés d'idempotence uniques pour chaque requête afin de permettre à l'API de reconnaître et de répondre de manière appropriée aux requêtes rejouées, empêchant le double traitement des sessions de vérification.

Simplifier l'intégration avec DiditL'API de Didit est conçue en tenant compte de l'idempotence, offrant une expérience axée sur les développeurs qui prend naturellement en charge les nouvelles tentatives fiables pour la vérification d'identité, la détection du vivant et le screening LCB, simplifiant ainsi votre processus d'intégration.

Le défi des systèmes distribués et de la vérification d'identité

Dans le paysage numérique interconnecté d'aujourd'hui, la vérification d'identité est la pierre angulaire de la confiance et de la sécurité. De l'intégration de nouveaux utilisateurs à la conformité aux réglementations LCB, les entreprises dépendent fortement des solutions d'identité basées sur des API. Cependant, la nature même des systèmes distribués — avec leurs latences réseau inhérentes, leurs délais d'attente et leur risque d'indisponibilité temporaire des services — introduit un défi majeur : comment s'assurer qu'une opération, comme le lancement d'une vérification d'identité, est traitée exactement une seule fois, même si la requête est envoyée plusieurs fois ?

Sans une conception minutieuse, un simple problème de réseau pourrait amener un client à relancer une requête, ce qui entraînerait le traitement multiple du même document d'identité ou de la même vérification de vitalité par le système de vérification. Cela gaspille non seulement des ressources, mais peut également entraîner des états incohérents, compliquer l'audit et dégrader l'expérience utilisateur. C'est là que le concept d'idempotence devient critique.

Qu'est-ce que l'idempotence et pourquoi est-elle importante pour le KYC ?

Une opération est idempotente si son exécution multiple produit le même résultat que son exécution unique. Dans le contexte des appels API, une requête idempotente signifie que si vous envoyez la même charge utile de requête avec la même clé d'idempotence à plusieurs reprises, le serveur ne la traitera qu'une seule fois, et les requêtes identiques ultérieures renverront le résultat original sans réexécuter l'action sous-jacente.

Pour les processus de connaissance du client (KYC) et de vérification d'identité, l'idempotence est primordiale :

• Prévention des vérifications en double : Imaginez qu'un utilisateur tente de vérifier son identité, mais qu'une erreur réseau empêche votre système de recevoir la réponse de succès. Sans idempotence, une nouvelle tentative pourrait lancer une deuxième session de vérification d'identité identique, entraînant un travail redondant et des frais potentiels.
• Assurer un état cohérent : Si un contrôle de screening LCB est initié et que la réponse est perdue, une nouvelle tentative avec un client idempotent garantit que le statut de screening original est renvoyé, plutôt que de déclencher un nouveau screening, potentiellement différent.
• Simplifier la gestion des erreurs : Les développeurs peuvent implémenter une logique de nouvelle tentative robuste sans craindre d'effets secondaires indésirables, rendant leur intégration plus résiliente et plus facile à déboguer.

Concevoir un client API idempotent

Pour créer un client API idempotent pour la vérification d'identité, vous devez utiliser des clés d'idempotence. Ce sont des jetons uniques, générés par le client, qui accompagnent chaque requête. Le serveur utilise cette clé pour détecter les requêtes en double dans un délai spécifique (par exemple, 24 heures).

1. Générer des clés d'idempotence uniques

Pour chaque opération logique unique que vous effectuez (par exemple, la création d'une nouvelle session de vérification pour un utilisateur spécifique), générez une clé d'idempotence unique. Un UUID (Universally Unique Identifier) est un excellent choix pour cela. Cette clé doit être associée à l'action spécifique que vous souhaitez rendre idempotente.

Exemple : Lors de l'initialisation d'une nouvelle session de vérification d'identité pour user_id_123, générez idempotency_key_abc.

2. Inclure la clé d'idempotence dans les requêtes

La plupart des API qui prennent en charge l'idempotence s'attendent à un en-tête spécifique, souvent Idempotency-Key, ou un champ dans le corps de la requête. Assurez-vous que votre client inclut systématiquement cette clé pour toutes les requêtes pertinentes, en particulier celles qui créent ou modifient des ressources.

3. Implémenter une logique de nouvelle tentative robuste

Lorsqu'une erreur transitoire se produit (par exemple, une erreur de serveur 5xx, un délai d'attente réseau), votre client doit relancer la requête en utilisant la même clé d'idempotence. Le backoff exponentiel avec gigue est une stratégie courante pour espacer les nouvelles tentatives et éviter de surcharger le serveur.

Considérez l'API Create Session pour la Console Professionnelle de Didit. Si vous créez un lien de vérification via l'API, vous pouvez envoyer une requête POST à /v3/session/. Si cette requête expire, vous pouvez la relancer avec la même clé d'idempotence. L'API Didit reconnaîtra la clé, et si une session a déjà été créée avec succès, elle renverra simplement les détails de la session existante, évitant ainsi un doublon. C'est crucial pour des produits comme la vérification d'identité de Didit et les contrôles de vitalité passifs et actifs.

4. Stocker et gérer les clés d'idempotence

Votre application cliente doit stocker la clé d'idempotence avec l'état de l'opération. Cela vous permet de récupérer la bonne clé si une nouvelle tentative est nécessaire. Assurez-vous que la clé est stockée de manière persistante si l'application est susceptible de planter ou de redémarrer entre la requête initiale et une éventuelle nouvelle tentative.

Au-delà de l'idempotence : renforcer la fiabilité avec les webhooks

Bien que l'idempotence gère efficacement les nouvelles tentatives, un système réellement fiable intègre également des webhooks. Didit, par exemple, envoie des mises à jour automatisées à votre URL de webhook configurée au fur et à mesure que l'utilisateur progresse dans un flux de vérification et lorsque le résultat final est prêt. Ce système de notification basé sur le push complète l'idempotence en fournissant des mises à jour de statut définitives, réduisant le besoin de votre client de sonder l'API et améliorant encore la résilience du système.

En combinant un client idempotent avec des notifications de webhook, vous obtenez une intégration très robuste : votre client peut relancer les requêtes en toute sécurité, et votre système reçoit des mises à jour en temps réel sur les résultats de vérification pour des produits tels que le screening et le suivi LCB et la preuve d'adresse, même si les réponses API initiales sont perdues.

Comment Didit vous aide

Didit est conçu dès le départ pour prendre en charge des intégrations hautement fiables et idempotentes, ce qui en fait un choix idéal pour les entreprises qui privilégient la robustesse et l'expérience développeur. Notre plateforme native AI offre une architecture modulaire, vous permettant de composer des flux de vérification avec facilité, et nos API sont construites en tenant compte de l'idempotence.

Lorsque vous créez une session pour la vérification d'identité Didit, la détection du vivant passive et active, la correspondance faciale 1:1 ou le screening LCB, notre système gère intrinsèquement l'idempotence de ces demandes de création. Cela signifie que votre équipe de développement peut se concentrer sur la création de votre produit principal, sachant que les tentatives de création de session ne mèneront pas à des vérifications dupliquées involontaires ou à des frais erronés. L'engagement de Didit envers une approche axée sur les développeurs comprend la fourniture d'une documentation complète et d'API claires qui simplifient la mise en œuvre de mécanismes de nouvelle tentative résilients. De plus, avec Didit's Free Core KYC, vous pouvez implémenter ces solutions robustes sans frais initiaux, ne payant que par vérification réussie. Notre modèle sans frais d'installation et nos capacités AI natives garantissent que vos processus de vérification d'identité sont non seulement fiables, mais aussi efficaces et évolutifs.

Prêt à commencer ?

Prêt à voir Didit en action ? Obtenez une démo gratuite dès aujourd'hui.

Commencez à vérifier les identités gratuitement avec le niveau gratuit de Didit.