Wir stellen unsere neue Client-Bibliothek für Android und iOS vor

Wir freuen uns, Ihnen unsere Client-Bibliothek für Android und iOSvorzustellen, ein neues SDK, das von Grund auf neu entwickelt wurde und es Entwicklern ermöglicht, WiFi zu umgehen und sicherzustellen, dass bestimmte API-Aufrufe ausschließlich über mobile Netzwerke gesendet werden. Diese Client-Bibliothek ersetzt die Verify Silent Auth und Numbers Verification SDKsdie keine Updates mehr erhalten werden.

Warum das wichtig ist

Einige Netzwerk-APIs, wie z. B. Numbers Verification API oder Verify API mit stummer Authentifizierungfunktionieren nur über Mobilfunknetze. Dies liegt daran, dass die Mobilfunkbetreiber zur Verifizierung der Nutzer auf die Daten des Netzverkehrs angewiesen sind.

Die neue Client-Bibliothek erzwingt, dass API-GET-Anfragen über das Mobilfunknetz gesendet werden, ohne dass die WiFi-Konnektivität auf den Benutzergeräten manuell ausgeschaltet werden muss.

Wie es funktioniert

Die Integration der Vonage Client Libary in Ihre mobile Anwendung ist ganz einfach. Mit nur wenigen Codezeilen können Entwickler ihre API-Anfragen über das Mobilfunknetz senden und bei Bedarf das WiFi umgehen.

Zeigen Sie es uns in Aktion!

Android

Um die Client-Bibliothek zu verwenden, fügen Sie die folgende Abhängigkeit zu Ihrer build.gradle Datei hinzu:

implementation 'com.vonage:client-library:1.0.0'

Importieren Sie die erforderlichen Pakete und initialisieren Sie die Bibliothek, bevor Sie API-Aufrufe tätigen:

import com.vonage.clientlibrary.VGCellularRequestClient
import com.vonage.clientlibrary.VGCellularRequestParameters

VGCellularRequestClient.initializeSdk(this.applicationContext)

Erstellen einer VGCellularRequestClientParameters Objekt mit den erforderlichen Parametern:

val params = VGCellularRequestClientParameters(
    url = "http://www.vonage.com",
    headers = mapOf("x-my-header" to "My Value") ,
    queryParameters = mapOf("query-param" to "value"),
    maxRedirectCount = 10
)

Wo:

• URL: entspricht einem API-Endpunkt.

• Header: eine Zuordnung von Strings mit den HTTP-Headern, die Sie in Ihre Anfrage aufnehmen möchten.

• queryParameters: eine Karte von Strings (Schlüssel-Wert-Paare) mit den Abfrageparametern, die in unsere GET-Anforderung aufgenommen werden sollen.

• maxRedirectCount: optional, Standardwert ist 10. Dieser Parameter legt die Anzahl der zulässigen Weiterleitungen fest. TBC

Rufen Sie schließlich die Funktion startCellularGetRequest auf, um die Anfrage über das Mobilfunknetz zu senden:

val response = VGCellularRequestClient.getInstance().startCellularGetRequest(params)

Die Methode unterstützt einen zweiten booleschen Parameter zum Debuggen von API-Aufrufen. Dieser Parameter ist standardmäßig auf false eingestellt, kann aber wie folgt aktiviert werden:

val response = 
VGCellularRequestClient.getInstance().startCellularGetRequest(params, true)

iOS

Ähnlich wie bei Android fügen Sie die Client-Bibliothek als Abhängigkeit zu Ihrem Projekt hinzu:

let package = Package(
    dependencies: [
        .Package(url: "https://github.com/Vonage/vonage-ios-client-library.git")
    ]
)

Sie können die Bibliothek auch über Cocoapodsinstallieren, indem Sie den Pod VonageClientLibrary.

Importieren und initialisieren Sie die Bibliothek:

import VonageClientLibrary

let client = VGCellularRequestClient()



Create a VGCellularRequestClientParameters object with the necessary parameters:
let params = VGCellularRequestParameters(url: "http://www.vonage.com",
                                headers: ["x-my-header": "My Value"],
                                queryParameters: ["query-param" : "value"]
                                maxRedirectCount: 10)

Verwenden Sie die startCellularGetRequest Methode, um die Anfrage über das Mobilfunknetz zu senden. Der zweite Parameter Fehlersuche ist optional und setzt das Debug-Flag (Standardwert ist false):

let response = try await client.startCellularRequest(params: params, debug: true)

Antworten

Wenn eine Antwort vom URL-Endpunkt empfangen wird, wird die startCellularGetRequest ein Objekt zurück, das die folgenden Eigenschaften enthält:

{
    "http_status": string, // HTTP status code of the URL response
    "response_body" : {    // Optional, depending on the HTTP status
        ...                // The response body of the requested url
    },
    "debug" : {            // Present if the debug flag is set to true
        "device_info": string, 
        "url_trace" : string
    }
}

Wenn keine Konnektivität besteht oder ein interner Fehler in der Client-Bibliothek vorliegt, enthält das Antwortobjekt die folgenden Eigenschaften:

{
    "error" : string,             // Error code
    "error_description": string,  // Error description
    "debug" : {                   // Present if debug flag is set to true
        "device_info": string, 
        "url_trace" : string
    }
}