Verify les détails techniques de l'API

Introduction

L'API Verify est la solution d'authentification à deux facteurs (2FA) de nouvelle génération de Vonage. Elle va au-delà des méthodes d'authentification traditionnelles en prenant en charge un éventail plus large de canaux, notamment les canaux OTT (Over-The-Top) tels que WhatsApp et le RCS, ainsi que les SMS, la voix et les e-mails.

Verify introduit des rappels d'événements et des rappels de résumé qui permettent des intégrations plus profondes et une plus grande personnalisation. Par exemple :

  • Vous pouvez configurer un webhook pour recevoir des rappels récapitulatifs, fournissant des informations détaillées sur les canaux qui ont réussi à se convertir et ceux qui n'ont pas réussi.
  • Les rappels d'événements permettent des expériences utilisateur avancées, telles que le flux Codeless de WhatsApp. Dans ce cas, l'utilisateur final peut simplement appuyer sur un bouton dans un message WhatsApp pour s'authentifier, ce qui déclenche un rappel d'événement vers votre backend pour poursuivre le flux de vérification.

Authentification

Verify exige que vous authentifiiez les demandes d'API de manière sécurisée. Pour en savoir plus sur la manière d'authentifier vos demandes d'API Verify, consultez la section Guide d'authentification.

Flux de travail

Le flux de travail définit la séquence des canaux utilisés pour fournir l'OTP à l'utilisateur final. Vous pouvez personnaliser l'ordre, les paramètres de délai et le comportement de repli pour optimiser l'expérience de vérification.

Vous trouverez des informations détaillées et des exemples dans le Guide du flux de travail.

Comment fonctionne l'API ?

Vous trouverez ci-dessous une représentation visuelle d'un flux de demandes Verify avec des rappels récapitulatifs :

Application client désigne l'application mobile ou Web avec laquelle vos utilisateurs finaux interagissent, tandis que Back-end de l'application fait référence à l'intégration côté serveur avec l'API Verify. Pour la configuration initiale et une présentation étape par étape, veuillez consulter le Guide de démarrage.

Langues prises en charge

L'API Verify prend en charge de nombreuses langues grâce à l'option locale (voir Référence API). Les Verify locale Le guide contient une liste des locale.

Rapports

L'API Reports constitue un moyen centralisé d'extraire les données d'utilisation et de reporting pour l'ensemble des produits Vonage. Elle offre ainsi aux développeurs et aux entreprises un moyen cohérent de suivre l'activité, la facturation et les détails des transactions, y compris les enregistrements d'appels et les numéros de téléphone. Elle simplifie la création de rapports en regroupant les données d'utilisation et de facturation provenant de plusieurs API Vonage dans un format unique et cohérent. Vous pouvez utiliser la Reports API dans un large éventail de cas d'utilisation, notamment :

  • Facturation des clients - Téléchargez les transactions liées à tous vos sous-comptes et utilisez les données de prix incluses pour déterminer ce que vous devez facturer à vos clients.
  • Rapprochement des factures - Comparez vos données d'utilisation avec la facture que vous avez reçue.
  • Surveillance et analyse - Ajoutez des données CDR en temps réel à votre système de veille stratégique ou d'analyse pour les mettre en corrélation avec d'autres événements.
  • Débogage - Résoudre les problèmes en explorant jusqu'à 13 mois de données d'utilisation détaillées.

Voir le Documentation sur les Reports API pour plus d'informations, notamment des guides, des extraits de code, des bonnes pratiques et les tarifs.

Quelle est la prochaine étape ?

Maintenant que vous comprenez les fondements techniques de l'API Verify, vous êtes prêt à commencer à construire !

  • Suivre le Guide de démarrage pour mettre en œuvre, étape par étape, votre premier flux de travail de vérification.

  • Explorer le Référence API pour une liste complète des points de terminaison, des paramètres et des options avancées.