com.nexmo.client.numbers

Class NumbersClient

java.lang.Object

com.nexmo.client.numbers.NumbersClient

public class NumbersClient
extends java.lang.Object

A client for accessing the Nexmo API calls that manage phone numbers.

Constructor Summary

Constructors

Constructor and Description
NumbersClient(HttpWrapper httpWrapper)

Method Summary

Modifier and Type	Method and Description
void	buyNumber(java.lang.String country, java.lang.String msisdn) Start renting a Nexmo Virtual Number.
void	cancelNumber(java.lang.String country, java.lang.String msisdn) Stop renting a Nexmo Virtual Number.
void	linkNumber(java.lang.String msisdn, java.lang.String country, java.lang.String appId) Link a given Nexmo Virtual Number to a Nexmo Application with the given ID.
ListNumbersResponse	listNumbers() Get the first page of phone numbers assigned to the authenticated account.
ListNumbersResponse	listNumbers(ListNumbersFilter filter) Get a filtered set of numbers assigned to the authenticated account.
SearchNumbersResponse	searchNumbers(SearchNumbersFilter filter) Search for available Nexmo Virtual Numbers.
SearchNumbersResponse	searchNumbers(java.lang.String country) Search for available Nexmo Virtual Numbers.
void	updateNumber(UpdateNumberRequest request) Update the callbacks and/or application associations for a given Nexmo Virtual Number.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NumbersClient

public NumbersClient(HttpWrapper httpWrapper)

Method Detail

listNumbers

public ListNumbersResponse listNumbers()
                                throws java.io.IOException,
                                       NexmoClientException

Get the first page of phone numbers assigned to the authenticated account.

Returns:

A ListNumbersResponse containing the first 10 phone numbers

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

listNumbers

public ListNumbersResponse listNumbers(ListNumbersFilter filter)
                                throws java.io.IOException,
                                       NexmoClientException

Get a filtered set of numbers assigned to the authenticated account.

Parameters:

filter - A ListNumbersFilter describing the filters to be applied to the request.

Returns:

A ListNumbersResponse containing phone numbers matching the supplied filter.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

searchNumbers

public SearchNumbersResponse searchNumbers(java.lang.String country)
                                    throws java.io.IOException,
                                           NexmoClientException

Search for available Nexmo Virtual Numbers.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

searchNumbers

public SearchNumbersResponse searchNumbers(SearchNumbersFilter filter)
                                    throws java.io.IOException,
                                           NexmoClientException

Search for available Nexmo Virtual Numbers.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

buyNumber

public void buyNumber(java.lang.String country,
                      java.lang.String msisdn)
               throws java.io.IOException,
                      NexmoClientException

Start renting a Nexmo Virtual Number.

Parameters:

country - A String containing a 2-character ISO country code.

msisdn - The phone number to be bought.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

cancelNumber

public void cancelNumber(java.lang.String country,
                         java.lang.String msisdn)
                  throws java.io.IOException,
                         NexmoClientException

Stop renting a Nexmo Virtual Number.

Parameters:

country - A String containing a 2-character ISO country code.

msisdn - The phone number to be cancelled.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

updateNumber

public void updateNumber(UpdateNumberRequest request)
                  throws java.io.IOException,
                         NexmoClientException

Update the callbacks and/or application associations for a given Nexmo Virtual Number.

Parameters:

request - Details of the updates to be made to the number association.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.

linkNumber

public void linkNumber(java.lang.String msisdn,
                       java.lang.String country,
                       java.lang.String appId)
                throws java.io.IOException,
                       NexmoClientException

Link a given Nexmo Virtual Number to a Nexmo Application with the given ID.

Parameters:

msisdn - The Nexmo Virtual Number to be updated.

country - The country for the given msisdn.

appId - The ID for the Nexmo Application to be associated with the number.

Throws:

java.io.IOException - if an error occurs contacting the Nexmo API

NexmoClientException - if an error is returned by the server.