Partager via

Démarrage rapide : Rechercher des informations d’opérateur pour un numéro de téléphone à l’aide de Azure Communication Services

  • Article

Important

Cette fonctionnalité d’Azure Communication Services est actuellement en préversion.

Ces interfaces de programmation d’applications et kits de développement logiciel (SDK) en préversion sont fournis sans contrat au niveau du service. Nous vous recommandons de ne pas les utiliser pour les charges de travail de production. Certaines fonctionnalités peuvent être limitées ou non prises en charge.

Pour plus d’informations, consultez Conditions d’utilisation supplémentaires relatives aux préversions de Microsoft Azure.

Prise en main de la bibliothèque de client Numéros de téléphone pour JavaScript afin de rechercher des informations d’opérateur pour les numéros de téléphone, qui peuvent être utilisées pour déterminer si et comment communiquer avec ce numéro de téléphone. Suivez ces étapes pour installer le package et rechercher des informations d’opérateur sur un numéro de téléphone.

Notes

Retrouvez le code ce démarrage rapide sur GitHub.

Prérequis

Vérification du prérequis

Dans une fenêtre de terminal ou de commande, exécutez la commande node --version pour vérifier que Node.js est installé.

Configuration

Pour configurer un environnement afin d’envoyer des requêtes de recherche, effectuez les étapes décrites dans les sections suivantes.

Créer une application Node.js

Dans une fenêtre de terminal ou de commande, créez un répertoire pour votre application, puis accédez-y.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Exécutez npm init -y pour créer un fichier package.json avec les paramètres par défaut.

npm init -y

Créez un fichier appelé number-lookup-quickstart.js à la racine du répertoire que vous avez créé. Ajoutez-lui l’extrait de code suivant :

async function main() {
    // quickstart code will go here
}

main();

Installer le package

Utilisez la commande npm install pour installer la bibliothèque de client Azure Communication Services Phone Numbers pour JavaScript.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

L’option --save ajoute la bibliothèque en tant que dépendance dans votre fichier package.json.

Exemples de code

Authentifier le client

Importez PhoneNumbersClient à partir de la bibliothèque cliente et instanciez-le avec votre chaîne de connexion, qui peut être acquise à partir d’une ressource Azure Communication Services sur le portail Azure. Nous vous recommandons d’utiliser une variable d’environnement COMMUNICATION_SERVICES_CONNECTION_STRING pour éviter d’insérer votre chaîne de connexion en texte brut dans votre code. Découvrez comment gérer la chaîne de connexion de la ressource.

Ajoutez le code suivant au début du fichier number-lookup-quickstart.js :

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

Rechercher le format d’un numéro de téléphone

Pour rechercher les informations d’opérateur d’un numéro de téléphone, appelez searchOperatorInformation à partir de PhoneNumbersClient.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

Remplacez par <target-phone-number> le numéro de téléphone que vous recherchez, généralement un numéro auquel vous souhaitez envoyer un message.

Avertissement

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123.

Rechercher des informations d’opérateur pour un nombre

Pour rechercher les informations d’opérateur d’un numéro de téléphone, appelez searchOperatorInformation à partir de PhoneNumbersClient, en passant true pour l’option includeAdditionalOperatorDetails.

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

Avertissement

L’utilisation de cette fonctionnalité entraîne des frais pour votre compte.

Utiliser les informations de l’opérateur

Vous pouvez maintenant utiliser les informations de l’opérateur. Pour ce guide de démarrage rapide, nous pouvons imprimer certains détails dans la console.

Tout d’abord, nous pouvons imprimer les détails du format numérique.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

Ensuite, nous pouvons imprimer les détails du numéro de téléphone et de l’opérateur.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

Vous pouvez également utiliser les informations de l’opérateur pour déterminer s’il faut envoyer un SMS. Pour plus d’informations sur l’envoi d’un SMS, consultez le guide de démarrage rapide SMS.

Exécuter le code

Exécutez l’application à partir de votre fenêtre de terminal ou de commande avec la commande node.

node number-lookup-quickstart.js

Exemple de code

Vous pouvez télécharger l’exemple d’application à partir de GitHub).

Prise en main de la bibliothèque de client Numéros de téléphone pour C# afin de rechercher des informations d’opérateur pour les numéros de téléphone, qui peuvent être utilisées pour déterminer si et comment communiquer avec ce numéro de téléphone. Suivez ces étapes pour installer le package et rechercher des informations d’opérateur sur un numéro de téléphone.

Notes

Retrouvez le code ce démarrage rapide sur GitHub.

Prérequis

Vérification du prérequis

Dans une fenêtre de terminal ou de commande, exécutez la commande dotnet pour vérifier que le kit de développement logiciel (SDK) .NET est installé.

Configuration

Pour configurer un environnement afin d’envoyer des requêtes de recherche, effectuez les étapes décrites dans les sections suivantes.

Créer une application C#

Dans un fenêtre de terminal ou de commande, utilisez la commande dotnet new pour créer une application console nommée NumberLookupQuickstart. Cette commande crée un projet C# simple nommé « Hello World » avec un seul fichier source : Program.cs.

dotnet new console -o NumberLookupQuickstart

Remplacez votre répertoire par le dossier d’application que vous venez de créer, puis utilisez la commande dotnet build pour compiler votre application.

cd NumberLookupQuickstart
dotnet build

Se connecter au flux de package de développement

La préversion publique du SDK est publiée dans un flux de package de développement. Vous pouvez ajouter le flux de développement en tirant parti de l’interface CLI NuGet qui l’ajoute au fichier NuGet.Config.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

Vous trouverez des informations plus détaillées et d’autres options pour la connexion au flux de développement dans le guide de contribution.

Installer le package

Toujours dans le répertoire de l’application, installez le package de la bibliothèque de client Communication Services PhoneNumbers pour .NET à l’aide de la commande suivante.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

Ajoutez une directive using en haut du fichier Program.cs pour inclure l’espace de noms Azure.Communication.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

Mettez à jour la signature de fonction Main pour qu’elle soit asynchrone.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

Exemples de code

Authentifier le client

Les clients Numéro de téléphone peuvent être authentifiés à l’aide de la chaîne de connexion obtenue à partir d’une ressource Azure Communication Services dans le portail Azure. Nous vous recommandons d’utiliser une variable d’environnement COMMUNICATION_SERVICES_CONNECTION_STRING pour éviter d’insérer votre chaîne de connexion en texte brut dans votre code. Découvrez comment gérer la chaîne de connexion de la ressource.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

Les clients de numéro de téléphone peuvent également s’authentifier à l’aide de l’authentification Microsoft Entra. Avec cette option, les variables d’environnement AZURE_CLIENT_SECRET, AZURE_CLIENT_ID et AZURE_TENANT_ID doivent être configurées pour l’authentification.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

Rechercher le format d’un numéro de téléphone

Pour rechercher le format national et international d’un numéro, appelez SearchOperatorInformationAsync à partir de PhoneNumbersClient.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

Remplacez par <target-phone-number> le numéro de téléphone que vous recherchez, généralement un numéro auquel vous souhaitez envoyer un message.

Avertissement

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123.

Rechercher des informations d’opérateur pour un nombre

Pour rechercher les informations d’opérateur d’un numéro de téléphone, appelez SearchOperatorInformationAsync à partir de PhoneNumbersClient, en passant true pour l’option IncludeAdditionalOperatorDetails.

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

Avertissement

L’utilisation de cette fonctionnalité entraîne des frais pour votre compte.

Utiliser les informations de l’opérateur

Vous pouvez maintenant utiliser les informations de l’opérateur. Pour ce guide de démarrage rapide, nous pouvons imprimer certains détails dans la console.

Tout d’abord, nous pouvons imprimer les détails du format numérique.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

Ensuite, nous pouvons imprimer les détails du numéro de téléphone et de l’opérateur.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

Vous pouvez également utiliser les informations de l’opérateur pour déterminer s’il faut envoyer un SMS. Pour plus d’informations sur l’envoi d’un SMS, consultez le guide de démarrage rapide SMS.

Exécuter le code

Exécutez l’application à partir de votre fenêtre de terminal ou de commande avec la commande dotnet run.

dotnet run --interactive

Exemple de code

Vous pouvez télécharger l’exemple d’application sur GitHub.

Prise en main de la bibliothèque de client Numéros de téléphone pour Java afin de rechercher des informations d’opérateur pour les numéros de téléphone, qui peuvent être utilisées pour déterminer si et comment communiquer avec ce numéro de téléphone. Suivez ces étapes pour installer le package et rechercher des informations d’opérateur sur un numéro de téléphone.

Notes

Retrouvez le code ce démarrage rapide sur GitHub.

Prérequis

Vérification du prérequis

Dans une fenêtre de terminal ou de commande, exécutez la commande mvn -v pour vérifier que Maven est installé.

Configuration

Pour configurer un environnement afin d’envoyer des requêtes de recherche, effectuez les étapes décrites dans les sections suivantes.

Créer une application Java

Dans une fenêtre de terminal ou de commande, accédez au répertoire dans lequel vous souhaitez créer votre application Java. Exécutez la commande suivante pour générer le projet Java à partir du modèle maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

La tâche « generate » crée un répertoire qui porte le même nom que artifactId. Sous ce répertoire, le répertoire src/main/java contient le code source du projet, src/test/java directory contient la source de test, et le fichier pom.xml est le modèle objet du projet (le POM).

Se connecter au flux de package de développement

La préversion publique du SDK est publiée dans un flux de package de développement. Pour vous connecter au flux de développement, ouvrez le fichier pom.xml dans votre éditeur de texte et ajoutez le dépôt de développement aux deux sections <repositories> et <distributionManagement> de votre fichier pom.xml, que vous pouvez ajouter si elles n’existent pas déjà.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

Vous devez peut-être ajouter ou modifier le fichier settings.xml dans ${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

Vous pouvez générer un jeton d’accès personnel avec les étendues de lecture et d’écriture de Packaging et le coller dans la balise <password>.

Vous trouverez des informations plus détaillées et d’autres options pour la connexion au flux de développement ici.

Installer le package

Ajoutez les éléments de dépendance suivants au groupe de dépendances dans le fichier pom.xml.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0-beta.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

Consultez la section properties pour vérifier que votre projet cible Maven version 1.8 ou ultérieure.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

Exemples de code

Configurer le framework d’application

À partir du répertoire de projet :

  1. Accéder au répertoire /src/main/java/com/communication/lookup/quickstart
  2. Ouvrez le fichier App.java dans votre éditeur
  3. Remplacez l’instruction System.out.println("Hello world!");
  4. Ajoutez des directives import.

Utilisez le code suivant pour commencer :

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

Authentifier le client

Le client peut être authentifié avec une chaîne de connexion obtenue à partir d’une ressource Azure Communication Services dans le portail Azure. Nous vous recommandons d’utiliser une variable d’environnement COMMUNICATION_SERVICES_CONNECTION_STRING pour éviter d’insérer votre chaîne de connexion en texte brut dans votre code. Découvrez comment gérer la chaîne de connexion de la ressource.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

Vous pouvez aussi l’authentifier avec l’authentification Microsoft Entra. L’utilisation de DefaultAzureCredentialBuilder est le moyen le plus simple de démarrer avec Microsoft Entra ID. Vous pouvez acquérir le nom de votre ressource à partir d’une ressource Azure Communication Services sur le portail Azure.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

Rechercher le format d’un numéro de téléphone

Pour rechercher le format national et international d’un numéro, appelez searchOperatorInformation à partir de PhoneNumbersClient.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

Remplacez par <target-phone-number> le numéro de téléphone que vous recherchez, généralement un numéro auquel vous souhaitez envoyer un message.

Avertissement

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123.

Rechercher des informations d’opérateur pour un nombre

Pour rechercher les informations d’opérateur d’un numéro de téléphone, appelez searchOperatorInformationWithResponse à partir de PhoneNumbersClient, en passant true pour l’option IncludeAdditionalOperatorDetails.

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

Avertissement

L’utilisation de cette fonctionnalité entraîne des frais pour votre compte.

Utiliser les informations de l’opérateur

Vous pouvez maintenant utiliser les informations de l’opérateur. Pour ce guide de démarrage rapide, nous pouvons imprimer certains détails dans la console.

Tout d’abord, nous pouvons imprimer les détails du format numérique.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

Ensuite, nous pouvons imprimer les détails du numéro de téléphone et de l’opérateur.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

Vous pouvez également utiliser les informations de l’opérateur pour déterminer s’il faut envoyer un SMS. Pour plus d’informations sur l’envoi d’un SMS, consultez le guide de démarrage rapide SMS.

Exécuter le code

Exécutez l’application à partir de votre fenêtre de terminal ou de commande avec les commandes suivantes : Accédez au répertoire contenant le fichier pom.xml et compilez le projet.

mvn compile

Ensuite, générez le package.

mvn package

Pour exécuter l’application, utilisez la commande mvn.

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

Exemple de code

Vous pouvez télécharger l’exemple d’application sur GitHub.

Prise en main de la bibliothèque de client Numéros de téléphone pour Python afin de rechercher des informations d’opérateur pour les numéros de téléphone, qui peuvent être utilisées pour déterminer si et comment communiquer avec ce numéro de téléphone. Suivez ces étapes pour installer le package et rechercher des informations d’opérateur sur un numéro de téléphone.

Notes

Retrouvez le code ce démarrage rapide sur GitHub.

Prérequis

Vérification du prérequis

Dans une fenêtre de terminal ou de commande, exécutez la commande python --version pour vérifier que Python est installé.

Configuration

Pour configurer un environnement afin d’envoyer des requêtes de recherche, effectuez les étapes décrites dans les sections suivantes.

Créer une application Python

Dans une fenêtre de terminal ou de commande, créez un répertoire pour votre application, puis accédez-y.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

Utilisez un éditeur de texte pour créer un fichier appelé number_lookup_sample.py dans le répertoire racine du projet et ajoutez le code suivant. Le code de démarrage rapide restant est ajouté dans les sections suivantes.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

Installer le package

Toujours dans le répertoire de l’application, installez le package de la bibliothèque de client Azure Communication Services PhoneNumbers pour Python à l’aide de la commande pip install.

pip install azure-communication-phonenumbers==1.2.0b2

Exemples de code

Authentifier le client

Le client peut être authentifié avec une chaîne de connexion obtenue à partir d’une ressource Azure Communication Services dans le portail Azure. Nous vous recommandons d’utiliser une variable d’environnement COMMUNICATION_SERVICES_CONNECTION_STRING pour éviter d’insérer votre chaîne de connexion en texte brut dans votre code. Découvrez comment gérer la chaîne de connexion de la ressource.

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

Le client peut aussi être authentifié avec l’authentification Microsoft Entra. Pour commencer à utiliser Microsoft Entra ID, le plus simple consister à utiliser l’objet DefaultAzureCredential. Vous pouvez l’installer à l’aide de la commande pip install.

pip install azure-identity

Pour créer un objet DefaultAzureCredential, les variables d'environnement AZURE_CLIENT_ID, AZURE_CLIENT_SECRET et AZURE_TENANT_ID doivent déjà être définies avec les valeurs correspondantes de votre application Microsoft Entra inscrite.

Pour savoir comment obtenir ces variables d’environnement, consultez le guide de configuration des principaux de service à partir de l’interface CLI.

Une fois la bibliothèque azure-identity installée, nous pouvons poursuivre l’authentification du client.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

Rechercher le format d’un numéro de téléphone

Pour rechercher le format national et international d’un numéro, appelez search_operator_information à partir de PhoneNumbersClient.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

Remplacez par <target-phone-number> le numéro de téléphone que vous recherchez, généralement un numéro auquel vous souhaitez envoyer un message.

Avertissement

Fournissez des numéros de téléphone au format standard international E.164, par exemple, +14255550123.

Rechercher des informations d’opérateur pour un nombre

Pour rechercher les informations d’opérateur d’un numéro de téléphone, appelez search_operator_information à partir de PhoneNumbersClient, en passant True pour l’option include_additional_operator_details.

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

Avertissement

L’utilisation de cette fonctionnalité entraîne des frais pour votre compte.

Utiliser les informations de l’opérateur

Vous pouvez maintenant utiliser les informations de l’opérateur. Pour ce guide de démarrage rapide, nous pouvons imprimer certains détails dans la console.

Tout d’abord, nous pouvons imprimer les détails du format numérique.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

Ensuite, nous pouvons imprimer les détails du numéro de téléphone et de l’opérateur.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

Vous pouvez également utiliser les informations de l’opérateur pour déterminer s’il faut envoyer un SMS. Pour plus d’informations sur l’envoi d’un SMS, consultez le guide de démarrage rapide SMS.

Exécuter le code

Exécutez l’application à partir de votre fenêtre de terminal ou de commande avec la commande python.

python number_lookup_sample.py

Exemple de code

Vous pouvez télécharger l’exemple d’application sur GitHub.

Dépannage

Questions et problèmes courantes :

  • Les changements des variables d’environnement peuvent ne pas prendre effet dans les programmes qui sont déjà en cours d’exécution. Si vous remarquez que vos variables d’environnement ne fonctionnent pas comme prévu, essayez de fermer et de rouvrir les programmes que vous utilisez pour exécuter et modifier le code.
  • Les données retournées par ce point de terminaison sont soumises à diverses lois et réglementations internationales. Par conséquent, l’exactitude des résultats dépend de plusieurs facteurs. Ces facteurs sont notamment : numéro porté ou non, indicatif de pays et état d’approbation de l’appelant. En fonction de ces facteurs, il se peut que l’information de l’opérateur ne soit pas disponible pour certains numéros de téléphone ou qu’elle reflète l’opérateur d’origine du numéro de téléphone, et non l’opérateur actuel.

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez appris comment :

  • Rechercher le format des numéros
  • Rechercher des informations de l’opérateur pour un numéro de téléphone

Concept de Recherche de nombre

Kit de développement logiciel (SDK) Recherche de nombre