Acheter un Numbers

Vous devez acheter une carte Vonage numéro virtuel si vous le souhaitez :

Passer ou recevoir des appels téléphoniques avec le Voice API
Recevoir des SMS entrants avec la fonction SMS API
Utilisez la messagerie multicanal avec le Messages API

Cette page vous montre comment acheter un numéro de manière programmatique.

Vous pouvez également annuler un numéro en ligne, à l'aide de la fonction tableau de bord du développeur ou à partir de la ligne de commande, en utilisant l'option CLI Vonage.

Remplacez les variables suivantes dans l'exemple de code par vos propres valeurs :

Clé	Description
`VONAGE_API_KEY`	Your Vonage API key (see it on your dashboard).
`VONAGE_API_SECRET`	Your Vonage API secret (also available on your dashboard).
`COUNTRY_CODE`	The two digit country code for the number. For example: `GB` for the United Kingdom
`VONAGE_NUMBER`	Your Vonage Number. E.g. `447700900000`

Rédiger le code

Ajouter ce qui suit à buy-number.sh:

curl -X POST \
  -u "${VONAGE_API_KEY}:${VONAGE_API_SECRET}" \
  "https://rest.nexmo.com/number/buy" \
  -H "Content-Type: application/x-www-form-urlencoded" \

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

sh buy-number.sh

Conditions préalables

npm install @vonage/server-sdk

Créez un fichier nommé buy-number.js et ajoutez le code suivant :

const { Vonage } = require('@vonage/server-sdk');

const vonage = new Vonage({
  apiKey: VONAGE_API_KEY,
  apiSecret: VONAGE_API_SECRET,
});

Voir la source complète

Rédiger le code

Ajouter ce qui suit à buy-number.js:

vonage.number.buyNumber({
  country: COUNTRY_CODE,
  msisdn: VONAGE_NUMBER,
})
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

node buy-number.js

Conditions préalables

Ajouter ce qui suit à build.gradle:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Créez un fichier nommé BuyNumber et ajoutez le code suivant à la méthode main:

val client = Vonage {
    apiKey(VONAGE_API_KEY)
    apiSecret(VONAGE_API_SECRET)
}

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier BuyNumber:

client.numbers.number(NUMBER_COUNTRY_CODE, NUMBER_MSISDN).buy()

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin application pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.kt.numbers par le paquet contenant BuyNumber:

gradle run -Pmain=com.vonage.quickstart.kt.numbers.BuyNumber

Conditions préalables

Ajouter ce qui suit à build.gradle:

implementation 'com.vonage:server-sdk:9.3.1'

Créez un fichier nommé BuyNumber et ajoutez le code suivant à la méthode main:

VonageClient client = VonageClient.builder()
        .apiKey(VONAGE_API_KEY)
        .apiSecret(VONAGE_API_SECRET)
        .build();

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier BuyNumber:

client.getNumbersClient().buyNumber(NUMBER_COUNTRY_CODE, NUMBER_MSISDN);

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin application pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.numbers par le paquet contenant BuyNumber:

gradle run -Pmain=com.vonage.quickstart.numbers.BuyNumber

Conditions préalables

Install-Package Vonage

Créez un fichier nommé BuyNumber.cs et ajoutez le code suivant :

using Vonage;
using Vonage.Numbers;
using Vonage.Request;

Voir la source complète

Ajouter ce qui suit à BuyNumber.cs:


var credentials = Credentials.FromApiKeyAndSecret(vonageApiKey, vonageApiSecret);

Voir la source complète

Rédiger le code

Ajouter ce qui suit à BuyNumber.cs:


var request = new NumberTransactionRequest() { Country = countryCode, Msisdn = vonageNumber };

Voir la source complète

Conditions préalables

composer require vonage/client

Créez un fichier nommé purchase.php et ajoutez le code suivant :

$basic = new \Vonage\Client\Credentials\Basic(VONAGE_API_KEY, VONAGE_API_SECRET);
$client = new \Vonage\Client($basic);

Voir la source complète

Rédiger le code

Ajouter ce qui suit à purchase.php:

try {
    $client->numbers()->purchase(VONAGE_NUMBER, COUNTRY_CODE);
    echo "Number purchased";
} catch (Exception $e) {
    echo "Error purchasing number";
}

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

php purchase.php

Conditions préalables

pip install vonage python-dotenv

Rédiger le code

Ajouter ce qui suit à buy.py:

from vonage import Auth, Vonage
from vonage_numbers import NumberParams, NumbersStatus

client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))

status: NumbersStatus = client.numbers.buy_number(
    params=NumberParams(
        country=NUMBER_COUNTRY_CODE,
        msisdn=NUMBER_MSISDN,
    )
)

print(status.model_dump())

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

python numbers/buy.py

Conditions préalables

gem install vonage

Créez un fichier nommé buy.rb et ajoutez le code suivant :

client = Vonage::Client.new(
  api_key: VONAGE_API_KEY,
  api_secret: VONAGE_API_SECRET
)

Voir la source complète

Rédiger le code

Ajouter ce qui suit à buy.rb:

response = client.numbers.buy(
  country: COUNTRY_CODE,
  msisdn: VONAGE_NUMBER
)

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

ruby buy.rb

Voir aussi

Référence API