Présentation de notre nouvelle bibliothèque client pour Android et iOS

Nous sommes heureux d'annoncer notre bibliothèque client pour Android et iOSun nouveau SDK conçu à partir de zéro qui permet aux développeurs de contourner le WiFi et de s'assurer que les appels d'API spécifiques sont envoyés exclusivement sur les réseaux mobiles. Cette bibliothèque client remplace le SDK Verify Silent Auth et Numbers Verification SDKsqui ne recevront plus de mises à jour.

Pourquoi c'est important

Certaines API de réseau, telles que API de vérification des numéros de vérification du numéro ou Verify API avec authentification silencieusene fonctionnent que sur les réseaux mobiles. En effet, les opérateurs de téléphonie mobile s'appuient sur les données de trafic du réseau pour vérifier les utilisateurs.

La nouvelle bibliothèque client permet d'envoyer des requêtes API GET via le réseau cellulaire sans avoir à désactiver manuellement la connectivité WiFi sur les appareils des utilisateurs.

Comment cela fonctionne-t-il ?

L'intégration de la bibliothèque client Vonage dans votre application mobile est simple. Avec seulement quelques lignes de code, les développeurs peuvent envoyer leurs demandes d'API par le biais du réseau mobile, en contournant le WiFi si nécessaire.

Voyons-le en action !

Android

Pour utiliser la bibliothèque client, ajoutez la dépendance suivante à votre fichier build.gradle la dépendance suivante :

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

Importez les paquets requis et initialisez la bibliothèque avant d'effectuer des appels d'API :

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

VGCellularRequestClient.initializeSdk(this.applicationContext)

Créer un VGCellularRequestClientParameters avec les paramètres nécessaires :

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

Où ?

• URL : correspond à un point de terminaison de l'API.

• En-têtes : une carte de chaînes contenant les en-têtes HTTP que vous souhaitez inclure dans votre requête.

• queryParameters : une carte de chaînes (paires clé-valeur) contenant les paramètres de requête à inclure dans notre demande GET.

• maxRedirectCount : facultatif, la valeur par défaut est 10. Ce paramètre définit le nombre de redirections autorisées. TBC

Enfin, appelez la commande startCellularGetRequest pour envoyer la demande via le réseau mobile :

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

La méthode prend en charge un deuxième paramètre booléen pour déboguer les appels d'API. La valeur par défaut de ce paramètre est false, mais il peut être activé de la manière suivante :

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

iOS

Comme pour Android, ajoutez la bibliothèque client en tant que dépendance dans votre projet :

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

Vous pouvez également installer la bibliothèque via Cocoapodsen utilisant le pod VonageClientLibrary.

Importer et initialiser la bibliothèque :

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)

Utiliser la fonction startCellularGetRequest pour envoyer la demande via le réseau mobile. Le deuxième paramètre debug est facultatif et définit le drapeau de débogage (faux par défaut) :

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

Réponses

Lorsqu'une réponse est reçue du point d'extrémité URL, la fonction startCellularGetRequest renvoie un objet contenant les propriétés suivantes :

{
    "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
    }
}

S'il n'y a pas de connectivité ou s'il y a une erreur interne dans la bibliothèque du client, l'objet de la réponse comprend les propriétés suivantes :

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