Ankündigung von Vonage Virtual Operator for Network APIs

Eine der häufigsten Fragen, die wir von Entwicklern erhalten, lautet: Wie kann ich die Netzwerk-APIs testen, wenn sie in meinem Land nicht verfügbar sind? Das muss nicht sein. Wir freuen uns, die Verfügbarkeit des Virtual Operator ankündigen zu können.

Der Virtual Operator bietet vordefinierte und deterministische API-Antworten, wenn Sie den Vonage Spielplatz. Er funktioniert wie ein regulärer Mobilfunkanbieter, akzeptiert aber nur API-Anfragen mit Telefonnummern, die das +990 Vorwahl verwenden.

Schauen wir uns an, wie es funktioniert!

Wie kann ich den virtuellen Operator aktivieren?

Die Verwendung des Virtual Operator ist ganz einfach. Erstellen Sie einfach eine Anwendung im Dashboard (oder verwenden Sie eine bestehende) und wählen Sie "Playground" unter dem Feld "Netzwerk-API-Funktionen". Das war's schon. Es ist keine weitere Konfiguration erforderlich. Von nun an werden alle API-Anfragen, die die mit dieser Anwendung verknüpften Anmeldeinformationen und Telefonnummern mit dem Präfix +990 Präfix werden an den Virtual Operator weitergeleitet.

Sobald die Anwendung fertig ist, gehen Sie auf die Seite Spielplatz um die verfügbaren Operatoren zu überprüfen, die im Playground unterstützt werden. Der erste Eintrag entspricht dem Virtual Operator:

Dashboard Playground Operators list

Beachten Sie, dass es nicht notwendig ist +990 Numbers in die Erlaubnisliste Ihres Spielplatzes aufzunehmen. Machen Sie einfach einen API-Aufruf zu einer der unterstützten Netzwerk-APIs.

Aufruf von Netzwerk-APIs mit dem virtuellen Operator

Der Virtual Operator liefert deterministische Antworten auf API-Anfragen mit Telefonnummern, die mit +990. Das Verhalten wird durch die Eingabeparameter in der API-Anfrage definiert, einschließlich verschiedener Bereiche in einigen Parametern oder bestimmter Telefonnummern-Endungen. Die Dokumentation enthält alle möglichen API-Antwortkombinationen für die unterstützten Netzwerk-APIs.

Zum Beispiel wird der /check Endpunkt der SIM Swap API immer true zurück, wenn der Parameter maxAge größer als 500 ist:

curl --url https://api-eu.vonage.com/camara/sim-swap/v040/check \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"phoneNumber": "+990123456", "maxAge": "500"}'

Falls wir das Szenario testen wollen, bei dem die API einen Fehler zurückgibt, können wir eine API-Anfrage mit einer Telefonnummer senden, die auf 99:

curl --url https://api-eu.vonage.com/camara/sim-swap/v040/check \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"phoneNumber": "+990123499, "maxAge": "500"}'

Denken Sie daran, dass die Authentifizierung auf die gleiche Weise erfolgen muss wie bei einem normalen Mobilfunkbetreiber.

Kontakt aufnehmen

Haben Sie den neuen Virtual Operator bereits genutzt? Wir würden uns über Ihr Feedback freuen! Schließen Sie sich uns auf dem Vonage Community Slack oder senden Sie uns eine Nachricht auf Xund wir werden uns bei Ihnen melden.

Vielen Dank fürs Lesen!