Delen via

Quickstart: Operatorgegevens opzoeken voor een telefoonnummer met behulp van Azure Communication Services

  • Artikel

Belangrijk

Deze functie van Azure Communication Services is momenteel beschikbaar als preview-versie.

Preview-API's en SDK's worden aangeboden zonder een service level agreement. U wordt aangeraden deze niet te gebruiken voor productieworkloads. Sommige functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden.

Raadpleeg aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

Ga aan de slag met de clientbibliotheek Telefoon Numbers voor JavaScript om operatorgegevens voor telefoonnummers op te zoeken, die kunnen worden gebruikt om te bepalen of en hoe u met dat telefoonnummer kunt communiceren. Volg deze stappen om het pakket te installeren en informatie over een telefoonnummer op te zoeken.

Notitie

Zoek de code voor deze quickstart op GitHub.

Vereisten

Controle van vereisten

Voer in een terminal- of opdrachtvenster de node --version opdracht uit om te controleren of Node.js is geïnstalleerd.

Instellen

Als u een omgeving wilt instellen voor het verzenden van opzoekquery's, voert u de stappen in de volgende secties uit.

Een nieuwe Node.js-toepassing maken

Maak in een terminal- of opdrachtvenster een nieuwe map voor uw app en navigeer ernaartoe.

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

Voer npm init -y uit om een package.json-bestand te maken met de standaardinstellingen.

npm init -y

Maak een bestand met de naam number-lookup-quickstart.js in de hoofdmap van de map die u hebt gemaakt. Voeg het volgende codefragment toe:

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

main();

Het pakket installeren

Gebruik de npm install opdracht om de Azure Communication Services-clientbibliotheek Telefoon Numbers voor JavaScript te installeren.

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

Met --save de optie wordt de bibliotheek toegevoegd als een afhankelijkheid in uw package.json-bestand .

Codevoorbeelden

De client verifiëren

Importeer de Telefoon NumbersClient uit de clientbibliotheek en instantieer deze met uw verbindingsreeks, die u kunt verkrijgen uit een Azure Communication Services-resource in Azure Portal. Het gebruik van een COMMUNICATION_SERVICES_CONNECTION_STRING omgevingsvariabele wordt aanbevolen om te voorkomen dat u uw verbindingsreeks in tekst zonder opmaak in uw code plaatst. Meer informatie over het beheren van de verbindingsreeks van uw resource.

Voeg de volgende code toe aan het begin van 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);

Opmaak van telefoonnummers opzoeken

Als u de operatorgegevens van een telefoonnummer wilt zoeken, belt searchOperatorInformation u vanaf de PhoneNumbersClient.

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

Vervang <target-phone-number> door het telefoonnummer waarnaar u op zoek bent, meestal een nummer waarnaar u een bericht wilt verzenden.

Waarschuwing

Geef telefoonnummers op in de internationale standaardindeling E.164, bijvoorbeeld +14255550123.

Operatorgegevens voor een getal opzoeken

Als u de operatorgegevens van een telefoonnummer wilt zoeken, belt searchOperatorInformation u vanaf de PhoneNumbersClientoperator en geeft u de includeAdditionalOperatorDetails optie doortrue.

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

Waarschuwing

Als u deze functionaliteit gebruikt, worden kosten in rekening gebracht voor uw account.

Operatorgegevens gebruiken

U kunt nu de operatorgegevens gebruiken. Voor deze snelstartgids kunnen we enkele details afdrukken naar de console.

Eerst kunnen we details over de getalnotatie afdrukken.

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

Vervolgens kunnen we details over het telefoonnummer en de operator afdrukken.

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"));

U kunt ook de operatorgegevens gebruiken om te bepalen of een sms moet worden verzonden. Zie de quickstart sms voor meer informatie over het verzenden van een sms.

De code uitvoeren

Voer de toepassing uit vanuit uw terminal of opdrachtvenster met de node opdracht.

node number-lookup-quickstart.js

Voorbeeldcode

U kunt de voorbeeld-app downloaden van GitHub).

Ga aan de slag met de clientbibliotheek Telefoon Nummers voor C# om operatorgegevens voor telefoonnummers op te zoeken, die kunnen worden gebruikt om te bepalen of en hoe u met dat telefoonnummer kunt communiceren. Volg deze stappen om het pakket te installeren en informatie over een telefoonnummer op te zoeken.

Notitie

Zoek de code voor deze quickstart op GitHub.

Vereisten

Controle van vereisten

Voer in een terminal- of opdrachtvenster de dotnet opdracht uit om te controleren of de .NET SDK is geïnstalleerd.

Instellen

Als u een omgeving wilt instellen voor het verzenden van opzoekquery's, voert u de stappen in de volgende secties uit.

Een nieuwe C#-toepassing maken

Voer in een terminal- of opdrachtvenster de dotnet new opdracht uit om een nieuwe console-app met de naam NumberLookupQuickstartte maken. Met deze opdracht maakt u een eenvoudig C#-project Hallo wereld met één bronbestand Program.cs.

dotnet new console -o NumberLookupQuickstart

Wijzig uw map in de zojuist gemaakte app-map en gebruik de opdracht dotnet build om uw toepassing te compileren.

cd NumberLookupQuickstart
dotnet build

Verbinding maken naar dev-pakketfeed

De openbare preview-versie van de SDK wordt gepubliceerd naar een dev-pakketfeed. U kunt de dev-feed toevoegen met behulp van de NuGet CLI, waarmee deze wordt toegevoegd aan het NuGet.Config-bestand.

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"

Meer gedetailleerde informatie en andere opties voor het maken van verbinding met de dev-feed vindt u in de gids voor bijdragen.

Het pakket installeren

Installeer in de toepassingsmap de Azure Communication Services Telefoon Numbers-clientbibliotheek voor .NET-pakket met behulp van de volgende opdracht.

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

Voeg een using-instructie toe aan het begin van Program.cs om de naamruimte Azure.Communication op te nemen.

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

Werk Main de functiehandtekening bij zodat deze asynchroon is.

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

Codevoorbeelden

De client verifiëren

Telefoon Nummerclients kunnen worden geverifieerd met behulp van verbindingsreeks verkregen uit een Azure Communication Services-resource in Azure Portal. Het gebruik van een COMMUNICATION_SERVICES_CONNECTION_STRING omgevingsvariabele wordt aanbevolen om te voorkomen dat u uw verbindingsreeks in tekst zonder opmaak in uw code plaatst. Meer informatie over het beheren van de verbindingsreeks van uw resource.

// 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));

Telefoon Nummerclients kunnen zich ook verifiëren met Microsoft Entra-verificatie. Met deze optie, AZURE_CLIENT_SECRETAZURE_CLIENT_IDen AZURE_TENANT_ID omgevingsvariabelen moeten worden ingesteld voor verificatie.

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

Opmaak van telefoonnummers opzoeken

Als u de nationale en internationale opmaak voor een nummer wilt opzoeken, belt u SearchOperatorInformationAsync van de PhoneNumbersClient.

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

Vervang <target-phone-number> door het telefoonnummer waarnaar u op zoek bent, meestal een nummer waarnaar u een bericht wilt verzenden.

Waarschuwing

Geef telefoonnummers op in de internationale standaardindeling E.164, bijvoorbeeld +14255550123.

Operatorgegevens voor een getal opzoeken

Als u de operatorgegevens van een telefoonnummer wilt zoeken, belt SearchOperatorInformationAsync u vanaf de PhoneNumbersClientoperator en geeft u de IncludeAdditionalOperatorDetails optie doortrue.

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

Waarschuwing

Als u deze functionaliteit gebruikt, worden kosten in rekening gebracht voor uw account.

Operatorgegevens gebruiken

U kunt nu de operatorgegevens gebruiken. Voor deze snelstartgids kunnen we enkele details afdrukken naar de console.

Eerst kunnen we details over de getalnotatie afdrukken.

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

Vervolgens kunnen we details over het telefoonnummer en de operator afdrukken.

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"}");

U kunt ook de operatorgegevens gebruiken om te bepalen of een sms moet worden verzonden. Zie de quickstart sms voor meer informatie over het verzenden van een sms.

De code uitvoeren

Voer de toepassing uit vanuit uw terminal of opdrachtvenster met de dotnet run opdracht.

dotnet run --interactive

Voorbeeldcode

U kunt de voorbeeld-app downloaden uit GitHub.

Ga aan de slag met de clientbibliotheek Telefoon Numbers voor Java om operatorgegevens voor telefoonnummers op te zoeken, die kunnen worden gebruikt om te bepalen of en hoe u met dat telefoonnummer kunt communiceren. Volg deze stappen om het pakket te installeren en informatie over een telefoonnummer op te zoeken.

Notitie

Zoek de code voor deze quickstart op GitHub.

Vereisten

Controle van vereisten

Voer in een terminal- of opdrachtvenster de mvn -v opdracht uit om te controleren of Maven is geïnstalleerd.

Instellen

Als u een omgeving wilt instellen voor het verzenden van opzoekquery's, voert u de stappen in de volgende secties uit.

Een nieuwe Java-toepassing maken

Navigeer in een terminal- of opdrachtvenster naar de map waarin u uw Java-toepassing wilt maken. Voer de volgende opdracht uit om het Java-project te genereren op basis van de maven-archetype-quickstart-sjabloon.

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

Met de taak 'genereren' wordt een map gemaakt met dezelfde naam als de artifactId. In deze map bevat de map src/main/Java de broncode van het project, de src/test/java directory bevat de testbron en het bestand pom.xml het projectobjectmodel van het project of POM.

Verbinding maken naar dev-pakketfeed

De openbare preview-versie van de SDK wordt gepubliceerd naar een dev-pakketfeed. Als u verbinding wilt maken met de dev-feed, opent u het pom.xml-bestand in de teksteditor en voegt u de dev-opslagplaats toe aan zowel de pom.xml <repositories> als <distributionManagement> secties die u kunt toevoegen als deze nog niet bestaan.

<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>

Mogelijk moet u het settings.xml bestand toevoegen of bewerken in ${user.home}/.m2

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

U kunt een persoonlijk toegangstoken genereren met lees- en schrijfbereiken voor pakketten en deze in de <password> tag plakken.

Meer gedetailleerde informatie en andere opties voor het maken van verbinding met de dev-feed vindt u hier.

Het pakket installeren

Voeg de volgende afhankelijkheidselementen toe aan de groep afhankelijkheden in het pom.xml-bestand .

<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>

Controleer de properties sectie om te controleren of uw project is gericht op Maven versie 1.8 of hoger.

<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>

Codevoorbeelden

Stel het app-framework in

Ga als volgt te werk vanuit de projectmap:

  1. Navigeer naar de map /src/main/java/com/communication/lookup/quickstart
  2. Open het bestand App.java in uw editor
  3. De System.out.println("Hello world!");-instructie vervangen
  4. Voeg import-instructies toe

Gebruik de volgende code om te beginnen:

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

De client verifiëren

De client kan worden geverifieerd met behulp van een verbindingsreeks verkregen uit een Azure Communication Services-resource in Azure Portal. Het gebruik van een COMMUNICATION_SERVICES_CONNECTION_STRING omgevingsvariabele wordt aanbevolen om te voorkomen dat u uw verbindingsreeks in tekst zonder opmaak in uw code plaatst. Meer informatie over het beheren van de verbindingsreeks van uw resource.

// 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();

U kunt ook verifiëren met behulp van Microsoft Entra-verificatie. Het gebruik van de is de eenvoudigste manier om aan de DefaultAzureCredentialBuilder slag te gaan met Microsoft Entra ID. U kunt uw resourcenaam verkrijgen uit een Azure Communication Services-resource in Azure Portal.

// 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();

Opmaak van telefoonnummers opzoeken

Als u de nationale en internationale opmaak voor een nummer wilt opzoeken, belt u searchOperatorInformation van 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);

Vervang <target-phone-number> door het telefoonnummer waarnaar u op zoek bent, meestal een nummer waarnaar u een bericht wilt verzenden.

Waarschuwing

Geef telefoonnummers op in de internationale standaardindeling E.164, bijvoorbeeld +14255550123.

Operatorgegevens voor een getal opzoeken

Als u de operatorgegevens van een telefoonnummer wilt zoeken, belt searchOperatorInformationWithResponse u vanaf de PhoneNumbersClientoperator en geeft u de IncludeAdditionalOperatorDetails optie doortrue.

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

Waarschuwing

Als u deze functionaliteit gebruikt, worden kosten in rekening gebracht voor uw account.

Operatorgegevens gebruiken

U kunt nu de operatorgegevens gebruiken. Voor deze snelstartgids kunnen we enkele details afdrukken naar de console.

Eerst kunnen we details over de getalnotatie afdrukken.

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

Vervolgens kunnen we details over het telefoonnummer en de operator afdrukken.

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);

U kunt ook de operatorgegevens gebruiken om te bepalen of een sms moet worden verzonden. Zie de quickstart sms voor meer informatie over het verzenden van een sms.

De code uitvoeren

Voer de toepassing uit vanuit uw terminal of opdrachtvenster met de volgende opdrachten: Navigeer naar de map met het pom.xml-bestand en compileer het project.

mvn compile

Bouw vervolgens het pakket.

mvn package

Gebruik de mvn opdracht om de app uit te voeren.

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

Voorbeeldcode

U kunt de voorbeeld-app downloaden uit GitHub.

Ga aan de slag met de clientbibliotheek Telefoon Nummers voor Python om operatorgegevens voor telefoonnummers op te zoeken, die kunnen worden gebruikt om te bepalen of en hoe u met dat telefoonnummer kunt communiceren. Volg deze stappen om het pakket te installeren en informatie over een telefoonnummer op te zoeken.

Notitie

Zoek de code voor deze quickstart op GitHub.

Vereisten

Controle van vereisten

Voer in een terminal- of opdrachtvenster de opdracht python --version uit om te controleren of Python is geïnstalleerd.

Instellen

Als u een omgeving wilt instellen voor het verzenden van opzoekquery's, voert u de stappen in de volgende secties uit.

Een nieuwe Python-toepassing maken

Maak in een terminal- of opdrachtvenster een nieuwe map voor uw app en navigeer ernaartoe.

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

Gebruik een teksteditor om een bestand te maken dat wordt aangeroepen number_lookup_sample.py in de hoofdmap van het project en voeg de volgende code toe. De resterende quickstart-code wordt toegevoegd in de volgende secties.

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)

Het pakket installeren

Installeer in de toepassingsmap de Azure Communication Services Telefoon Getals-clientbibliotheek voor het Python-pakket met behulp van de pip install opdracht.

pip install azure-communication-phonenumbers==1.2.0b2

Codevoorbeelden

De client verifiëren

De client kan worden geverifieerd met behulp van een verbindingsreeks verkregen uit een Azure Communication Services-resource in Azure Portal. Het gebruik van een COMMUNICATION_SERVICES_CONNECTION_STRING omgevingsvariabele wordt aanbevolen om te voorkomen dat u uw verbindingsreeks in tekst zonder opmaak in uw code plaatst. Meer informatie over het beheren van de verbindingsreeks van uw resource.

# 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)

De client kan ook worden geverifieerd met behulp van Microsoft Entra-verificatie. DefaultAzureCredential Het object is de eenvoudigste manier om aan de slag te gaan met Microsoft Entra ID en u kunt het installeren met behulp van de pip install opdracht.

pip install azure-identity

Als u een DefaultAzureCredential object maakt, moet u deze AZURE_CLIENT_SECREThebben AZURE_CLIENT_IDen AZURE_TENANT_ID al instellen als omgevingsvariabelen met de bijbehorende waarden uit uw geregistreerde Microsoft Entra-toepassing.

Voor een overzicht van hoe u deze omgevingsvariabelen kunt ophalen, kunt u leren hoe u service-principals kunt instellen vanuit CLI.

Zodra de azure-identity bibliotheek is geïnstalleerd, kunt u doorgaan met het verifiëren van de 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)

Opmaak van telefoonnummers opzoeken

Als u de nationale en internationale opmaak voor een nummer wilt opzoeken, belt u search_operator_information van de PhoneNumbersClient.

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

Vervang <target-phone-number> door het telefoonnummer waarnaar u op zoek bent, meestal een nummer waarnaar u een bericht wilt verzenden.

Waarschuwing

Geef telefoonnummers op in de internationale standaardindeling E.164, bijvoorbeeld +14255550123.

Operatorgegevens voor een getal opzoeken

Als u de operatorgegevens van een telefoonnummer wilt zoeken, belt search_operator_information u vanaf de PhoneNumbersClientoperator en geeft u de include_additional_operator_details optie doorTrue.

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

Waarschuwing

Als u deze functionaliteit gebruikt, worden kosten in rekening gebracht voor uw account.

Operatorgegevens gebruiken

U kunt nu de operatorgegevens gebruiken. Voor deze snelstartgids kunnen we enkele details afdrukken naar de console.

Eerst kunnen we details over de getalnotatie afdrukken.

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))

Vervolgens kunnen we details over het telefoonnummer en de operator afdrukken.

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))

U kunt ook de operatorgegevens gebruiken om te bepalen of een sms moet worden verzonden. Zie de quickstart sms voor meer informatie over het verzenden van een sms.

De code uitvoeren

Voer de toepassing uit vanuit uw terminal of opdrachtvenster met de python opdracht.

python number_lookup_sample.py

Voorbeeldcode

U kunt de voorbeeld-app downloaden uit GitHub.

Probleemoplossing

Veelvoorkomende vragen en problemen:

  • Wijzigingen in omgevingsvariabelen worden mogelijk niet doorgevoerd in programma's die al worden uitgevoerd. Als u merkt dat uw omgevingsvariabelen niet werken zoals verwacht, sluit en opent u alle programma's die u gebruikt om code uit te voeren en te bewerken.
  • De gegevens die door dit eindpunt worden geretourneerd, zijn onderworpen aan verschillende internationale wet- en regelgeving, daarom is de nauwkeurigheid van de resultaten afhankelijk van verschillende factoren. Deze factoren omvatten of het nummer is overgezet, de landcode en de goedkeuringsstatus van de aanroeper. Op basis van deze factoren zijn operatorgegevens mogelijk niet beschikbaar voor sommige telefoonnummers of worden de oorspronkelijke operator van het telefoonnummer weergegeven, niet de huidige operator.

Volgende stappen

In deze Snelstart hebt u de volgende zaken geleerd:

  • Getalopmaak opzoeken
  • Operatorgegevens opzoeken voor een telefoonnummer

Getalzoekconcept

Number Lookup SDK