Pesquisar números disponíveis

Esta página mostra como pesquisar, por meio de programação, números disponíveis para compra.

Você também pode pesquisar números disponíveis on-line, usando o painel do desenvolvedor ou pela linha de comando, usando o CLI da Vonage.

Substitua as seguintes variáveis no código de exemplo pelos seus próprios valores:

Chave	Descrição
`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_TYPE`	The type of number: `landline`, `mobile-lvn` or `landline-toll-free`
`VONAGE_NUMBER_FEATURES`	The capabilities of the number: `SMS`, `VOICE` or `SMS,VOICE` for both
`NUMBER_SEARCH_CRITERIA`	The filter criteria. For example, numbers containing `234`.
`NUMBER_SEARCH_PATTERN`	Where the `NUMBER_SEARCH_CRITERIA` should appear in the number: `0` - At the beginning of the number `1`- Anywhere in the number `2` - At the end of the number

Escreva o código

Adicione o seguinte ao arquivo ` search-numbers.sh`:

curl \
  -u "${VONAGE_API_KEY}:${VONAGE_API_SECRET}" \
  "https://rest.nexmo.com/number/search?country=$COUNTRY_CODE&type=$VONAGE_NUMBER_TYPE&features=$VONAGE_NUMBER_FEATURES&pattern=$NUMBER_SEARCH_CRITERIA&search_pattern=$NUMBER_SEARCH_PATTERN"

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

sh search-numbers.sh

Pré-requisitos

npm install @vonage/server-sdk

Crie um arquivo chamado ` search-numbers.js ` e insira o seguinte código:

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

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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` search-numbers.js`:

vonage.numbers.getOwnedNumbers({
  country: COUNTRY_CODE,
  type: VONAGE_NUMBER_TYPE,
  pattern: NUMBER_SEARCH_CRITERIA,
  searchPattern: NUMBER_SEARCH_PATTERN,
  features: VONAGE_NUMBER_FEATURES,
})
  .then((numbers) => {
    for (const number of numbers) {
      console.log(number);
    }
  })
  .catch((error) => console.error(error));

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

node search-numbers.js

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

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

Crie um arquivo chamado ` SearchAvailableNumbers ` e adicione o código a seguir ao método ` main `:

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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao método ` main ` do arquivo ` SearchAvailableNumbers `:

val numbers = client.numbers.searchAvailable {
    country(NUMBER_COUNTRY_CODE)
    type(NUMBER_TYPE)
    features(*NUMBER_FEATURES)
    pattern(NUMBER_SEARCH_PATTERN, NUMBER_SEARCH_CRITERIA)
}
for (number in numbers) {
    println("""
        Tel: ${number.msisdn}
        Country: ${number.country}
        Type: ${number.type}
        Cost: ${number.cost}
        """.trimIndent()
    )
}

Ver código-fonte completo

Execute seu código

Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:

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

Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.kt.numbers ` pelo pacote que contém ` SearchAvailableNumbers`:

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

Pré-requisitos

Adicione o seguinte ao arquivo ` build.gradle`:

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

Crie um arquivo chamado ` SearchNumbers ` e adicione o código a seguir ao método ` main `:

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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao método ` main ` do arquivo ` SearchNumbers `:

SearchNumbersResponse response = client.getNumbersClient().searchNumbers(
        SearchNumbersFilter.builder()
            .country(NUMBER_COUNTRY_CODE)
            .type(NUMBER_TYPE)
            .features(NUMBER_FEATURES)
            .pattern(NUMBER_SEARCH_PATTERN, NUMBER_SEARCH_CRITERIA)
            .build()
);

System.out.println("Here are "
        + response.getNumbers().length
        + " of the " + response.getCount()
        + " matching numbers available for purchase."
);

for (AvailableNumber number : response.getNumbers()) {
    System.out.println("Tel: " + number.getMsisdn());
    System.out.println("Cost: " + number.getCost());
}

Ver código-fonte completo

Execute seu código

Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:

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

Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.numbers ` pelo pacote que contém ` SearchNumbers`:

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

Pré-requisitos

Install-Package Vonage

Crie um arquivo chamado ` SearchNumbers.cs ` e insira o seguinte código:

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

Ver código-fonte completo

Adicione o seguinte ao arquivo ` SearchNumbers.cs`:


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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` SearchNumbers.cs`:


var request = new NumberSearchRequest()
{
    Country = countryCode,
    Type = vonageNumberType,
    Features = vonageNumberFeatures,
    Pattern = numberSearchCriteria,
    SearchPattern = numberSearchPattern
};

Ver código-fonte completo

Pré-requisitos

composer require vonage/client

Crie um arquivo chamado ` search-available.php ` e insira o seguinte código:

use Vonage\Numbers\Filter\AvailableNumbers;
use Vonage\Entity\IterableAPICollection;

Ver código-fonte completo

Adicione o seguinte ao arquivo ` search-available.php`:

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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` search-available.php`:

/** @var IterableAPICollection $response */
$filter = new AvailableNumbers([
    "pattern" => (string) NUMBER_SEARCH_CRITERIA,
    "search_pattern" => (int) NUMBER_SEARCH_PATTERN,
    "type" => VONAGE_NUMBER_TYPE,
    "features" => VONAGE_NUMBER_FEATURES,
]);
$response = $client->numbers()->searchAvailable(COUNTRY_CODE, $filter);

echo "There are " . count($response) . " matching numbers available for purchase:\n";

foreach ($response as $number) {
    echo "Tel: " . $number->getMsisdn() . " Cost: " . $number->getCost() . "\n";
}

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

php search-available.php

Pré-requisitos

pip install vonage python-dotenv

Escreva o código

Adicione o seguinte ao arquivo ` search.py`:

from vonage import Auth, Vonage
from vonage_numbers import SearchAvailableNumbersFilter

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

numbers, count, next = client.numbers.search_available_numbers(
    SearchAvailableNumbersFilter(
        country=NUMBER_COUNTRY_CODE,
        size=3,
        pattern=NUMBER_SEARCH_CRITERIA,
        search_pattern=NUMBER_SEARCH_PATTERN,
        type=NUMBER_TYPE,
        features=NUMBER_FEATURES,
    )
)
pprint(numbers)
print(count)
print(next)

for number in numbers:
    print(f'Tel: {number.msisdn} Cost: {number.cost}')

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

python numbers/search.py

Pré-requisitos

gem install vonage

Crie um arquivo chamado ` search.rb ` e insira o seguinte código:

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

Ver código-fonte completo

Escreva o código

Adicione o seguinte ao arquivo ` search.rb`:

response = client.numbers.search(
  country: COUNTRY_CODE,
  msisdn: VONAGE_NUMBER,
  type: VONAGE_NUMBER_TYPE,
  features: VONAGE_NUMBER_FEATURES,
  pattern: NUMBER_SEARCH_CRITERIA,
  search_pattern: NUMBER_SEARCH_PATTERN
)

Ver código-fonte completo

Execute seu código

Salve este arquivo no seu computador e execute-o:

ruby search.rb

Veja também

Referência da API