16.02.2021
Zadarma

Mit der neuen API-Methode können Unternehmen Telefonnummern von Kunden mit einem Anruf bestätigen. Diese Autorisierung ist günstiger als SMS und geeignet für viele Websites und Anwendungen.

Wie funktioniert es?

  1. Der Kunde gibt seine Telefonnummer auf Ihrer Website ein
  2. Sie generieren einen Code und senden eine API-Anfrage, um die Nummer zu überprüfen
  3. Der Roboter ruft den Kunde an und nennt den Code
  4. Der Kunde gibt den Code auf Ihrer Website ein und bestätigt damit seine Telefonnummer

Für wen und für was

Wofür müssen Sie die Autorisierung der Telefonnummer verwenden:

  • Zwei-Faktor-Authentifizierung
  • Anmeldung
  • Passwort Wiederherstellung

Die alte Methode mit Registrierung eines Kunden per E-Mail und zwei korrekt eingegebenen Passwörtern ist immer noch aktuell. Inzwischen müssen Unternehmen ihre Kunden jedoch zunehmend anhand ihrer Telefonnummer überprüfen.

Bei der Autorisierung per SMS gibt es zwei Probleme: Es ist eine kostenintensive Methode für das Unternehmen und nicht immer eine Sichere. Kunden verwenden temporäre virtuelle Nummern. Daher ist die Registrierung und weitere Zwei-Faktor-Autorisierung durch Anrufen heute der beste Weg, um die Identität ihrer kunden zu verifizieren.

So implementieren Sie diese Methode

Die offene Zadarma-API verfügt über eine request_checknumber - Methode.

Parameter hierzu sind:

  • caller_id — die Nummer, von der der Anruf getätigt wird. Dies muss eine virtuelle Zadarma-Nummer sein;
  • to — die Nummer des Kunden, den der Roboter anrufen soll;
  • code — der Code zum wiedergeben. Eine Reihe von Zahlen, die Sie definieren und der Sprachroboter dem Kunde mitteilt. Die maximale Länge beträgt 20 Zeiche;
  • lang — die Sprache, die für Code-Wiedergabe verwendet wird. Falls nicht definiert, wird die Sprache Ihres Accounts verwendet. Verfügbare Sprachen sind - Russisch, Englisch, Spanisch, Polnisch, Deutsch, Französisch, Ukrainisch.

Sie generieren den Code, senden eine API-Anfrage und warten, bis der Kunde diesen Code auf Ihrer Website eingibt..

Was brauchen Sie, um loszulegen?

Ein paar einfache Schritte, um die Autorisierung nach Telefonnummer in Ihrem Dienst zu verwenden:

  1. Registrieren Sie sich bei Zadarma-Service
  2. Aktivieren Sie eine virtuelle Nummer (dies ist eine Voraussetzung, - Anrufe an Kunden dürfen nur von der bei Zadarma aktivierten Nummer erfolgen)
  3. Erstellen Sie einen API-Autorisierungsschlüssel und können diese Methode nutzen

Zur Vereinfachung der Arbeit mit der Zadarma-API empfehlen wir die Verwendung der offiziellen Bibliothek (PHP, Python und C#).

Nach der Installation der offiziellen Bibliothek müssen Sie Ihre API-Schlüssel in den Include-Dateien festlegen. Ein Beispiel für eine Anfrage mit einem Client in PHP::


<?php

use Zadarma_API\Api;

require_once __DIR__.DIRECTORY_SEPARATOR.'include.php';

define('USE_SANDBOX', false);
$api = new Api(KEY, SECRET, USE_SANDBOX);

$api->call('/v1/request/checknumber/', [
	"caller_id" => "442037691880",
	"to" => "442037691881",
	"code" => "1234567890",
	"lang" => "fr"
]);

Typische Antwort auf diese Anfrage (erfolgreich):


{
    "status":"success",
    "from":442037691880,
    "to":442037691881,
    "lang":"fr",
    "time":1612779278
}

Executed time: 0.19358