Technische Details der API verifizieren

Einführung

Die Verify API ist die Lösung der nächsten Generation für die Zwei-Faktor-Authentifizierung (2FA) von Vonage. Sie geht über herkömmliche Authentifizierungsmethoden hinaus und unterstützt eine größere Bandbreite an Kanälen, darunter Over-the-Top-Kanäle (OTT) wie WhatsApp und RCS sowie SMS, Sprachanrufe und E-Mail.

Verify führt Ereignisrückrufe und Zusammenfassungsrückrufe ein, die tiefere Integrationen und größere Anpassungen ermöglichen. Zum Beispiel:

  • Sie können einen Webhook so konfigurieren, dass er zusammenfassende Rückrufe empfängt, die detaillierte Informationen darüber liefern, welche Kanäle erfolgreich konvertiert haben und welche nicht.
  • Ereignisrückrufe ermöglichen fortgeschrittene Benutzererfahrungen, wie z.B. den WhatsApp Codeless Flow. In diesem Fall kann ein Endbenutzer einfach auf eine Schaltfläche in einer WhatsApp-Nachricht tippen, um sich zu authentifizieren, was einen Ereignis-Callback an Ihr Backend auslöst, um den Verifizierungsfluss fortzusetzen.

Authentifizierung

Verify erfordert, dass Sie API-Anfragen sicher authentifizieren. Weitere Informationen über die Authentifizierung Ihrer Verify-API-Anfragen finden Sie in der Leitfaden zur Authentifizierung.

Arbeitsablauf

Der Arbeitsablauf definiert die Reihenfolge der Kanäle, die zur Übermittlung des OTP an den Endbenutzer verwendet werden. Sie können die Reihenfolge, die Timeout-Einstellungen und das Fallback-Verhalten anpassen, um die Überprüfung zu optimieren.

Ausführliche Informationen und Beispiele finden Sie in der Workflow-Leitfaden.

Wie funktioniert die API?

Nachfolgend finden Sie eine visuelle Darstellung eines Verify-Anfrageflusses mit zusammenfassenden Rückrufen:

Client-App bezieht sich auf die Mobil- oder Webanwendung, mit der Ihre Endnutzer interagieren, während App-Backend bezieht sich auf die serverseitige Integration mit der Verify-API. Informationen zur Ersteinrichtung und eine Schritt-für-Schritt-Anleitung finden Sie unter Leitfaden für erste Schritte.

Unterstützte Sprachen

Die Verify API unterstützt viele Sprachen mit dem locale Parameter (siehe API-Referenz). Die Website Gebietsschema verifizieren Handbuch enthält eine Liste der unterstützten locale.

Berichterstattung

Die Reports API ist eine zentrale Möglichkeit, Nutzungs- und Berichtsdaten für alle Vonage-Produkte abzurufen. Sie bietet Entwicklern und Unternehmen eine einheitliche Methode zur Nachverfolgung von Aktivitäten, Abrechnungs- und Transaktionsdetails, einschließlich Anrufprotokollen und Telefonnummern. Sie vereinfacht die Berichterstellung, indem sie Nutzungs- und Abrechnungsdaten aus verschiedenen Vonage-APIs in ein einheitliches Format zusammenführt. Sie können die Reports API in einer Vielzahl von Anwendungsfällen nutzen, darunter:

  • Kundenfakturierung - Laden Sie die Transaktionen für alle Ihre Unterkonten herunter und verwenden Sie die enthaltenen Preisdaten, um zu bestimmen, was Sie Ihren Kunden in Rechnung stellen wollen.
  • Rechnungsabgleich - Vergleichen Sie Ihre Nutzungsdaten mit der Rechnung, die Sie erhalten haben.
  • Überwachung und Analyse - Fügen Sie CDR-Daten in Echtzeit zu Ihrem Business Intelligence- oder Analysesystem hinzu, um sie mit anderen Ereignissen in Beziehung zu setzen.
  • Fehlersuche - Beheben Sie Probleme, indem Sie bis zu 13 Monate an detaillierten Nutzungsdaten auswerten.

Siehe die Reports API-Dokumentation Weitere Informationen, darunter Anleitungen, Code-Ausschnitte, bewährte Vorgehensweisen und Preisangaben.

Was kommt als Nächstes?

Nachdem Sie nun die technischen Grundlagen der Verify-API verstanden haben, können Sie mit der Entwicklung beginnen!

  • Folgen Sie der Leitfaden für erste Schritte um Ihren ersten Überprüfungsworkflow Schritt für Schritt zu implementieren.

  • Erforschen Sie die API-Referenz für eine vollständige Liste der Endpunkte, Parameter und erweiterten Optionen.