Package com.vonage.client.insight

Class InsightClient

java.lang.Object

com.vonage.client.insight.InsightClient

public class InsightClient
extends Object

A client for talking to the Vonage Number Insight API. The standard way to obtain an instance of this class is to use VonageClient.getInsightClient().

Constructor Summary

Constructors

Constructor	Description
InsightClient(HttpWrapper wrapper)	Constructor.

Method Summary

Modifier and Type	Method	Description
AdvancedInsightResponse	getAdvancedNumberInsight(AdvancedInsightRequest advancedInsightRequest)	Perform an Advanced Insight Request with a AdvancedInsightRequest.
AdvancedInsightResponse	getAdvancedNumberInsight(String number)	Perform an Advanced Insight Request with a number.
AdvancedInsightResponse	getAdvancedNumberInsight(String number, String country)	Perform an Advanced Insight Request with a number and country.
BasicInsightResponse	getBasicNumberInsight(BasicInsightRequest basicInsightRequest)	Perform a Basic Insight Request with a BasicInsightRequest.
BasicInsightResponse	getBasicNumberInsight(String number)	Perform a Basic Insight Request with a number.
BasicInsightResponse	getBasicNumberInsight(String number, String country)	Perform a Basic Insight Request with a number and country.
StandardInsightResponse	getStandardNumberInsight(StandardInsightRequest standardInsightRequest)	Perform a Standard Insight Request with a StandardInsightRequest.
StandardInsightResponse	getStandardNumberInsight(String number)	Perform a Standard Insight Request with a number.
StandardInsightResponse	getStandardNumberInsight(String number, String country)	Perform a Standard Insight Request with a number and country.

Methods inherited from class java.lang.Object

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

Constructor Details

InsightClient

public InsightClient(HttpWrapper wrapper)

Constructor.

Parameters:

wrapper - (REQUIRED) shared HTTP wrapper object used for making REST calls.

Method Details

getBasicNumberInsight

public BasicInsightResponse getBasicNumberInsight(String number)
                                           throws VonageResponseParseException,
VonageClientException

Perform a Basic Insight Request with a number.

Parameters:

number - A single phone number that you need insight about in national or international format.

Returns:

A BasicInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getBasicNumberInsight

public BasicInsightResponse getBasicNumberInsight(String number,
 String country)
                                           throws VonageResponseParseException,
VonageClientException

Perform a Basic Insight Request with a number and country.

Parameters:

number - A single phone number that you need insight about in national or international format

country - If a number does not have a country code or it is uncertain, set the two-character country code.

Returns:

A BasicInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getBasicNumberInsight

public BasicInsightResponse getBasicNumberInsight(BasicInsightRequest basicInsightRequest)
                                           throws VonageResponseParseException,
VonageClientException

Perform a Basic Insight Request with a BasicInsightRequest.

Parameters:

basicInsightRequest - A request object containing the details of the request to make.

Returns:

A BasicInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getStandardNumberInsight

public StandardInsightResponse getStandardNumberInsight(String number)
                                                 throws VonageResponseParseException,
VonageClientException

Perform a Standard Insight Request with a number.

Parameters:

number - A single phone number that you need insight about in national or international format.

Returns:

A StandardInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getStandardNumberInsight

public StandardInsightResponse getStandardNumberInsight(String number,
 String country)
                                                 throws VonageResponseParseException,
VonageClientException

Perform a Standard Insight Request with a number and country.

Parameters:

number - A single phone number that you need insight about in national or international format.

country - If a number does not have a country code or it is uncertain, set the two-character country code.

Returns:

A StandardInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getStandardNumberInsight

public StandardInsightResponse getStandardNumberInsight(StandardInsightRequest standardInsightRequest)
                                                 throws VonageResponseParseException,
VonageClientException

Perform a Standard Insight Request with a StandardInsightRequest.

Parameters:

standardInsightRequest - A request object containing the details of the request to make.

Returns:

A StandardInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getAdvancedNumberInsight

public AdvancedInsightResponse getAdvancedNumberInsight(String number)
                                                 throws VonageResponseParseException,
VonageClientException

Perform an Advanced Insight Request with a number.

Parameters:

number - A single phone number that you need insight about in national or international format.

Returns:

A AdvancedInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getAdvancedNumberInsight

public AdvancedInsightResponse getAdvancedNumberInsight(String number,
 String country)
                                                 throws VonageResponseParseException,
VonageClientException

Perform an Advanced Insight Request with a number and country.

Parameters:

number - A single phone number that you need insight about in national or international format.

country - If a number does not have a country code or it is uncertain, set the two-character country code.

Returns:

A AdvancedInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.

getAdvancedNumberInsight

public AdvancedInsightResponse getAdvancedNumberInsight(AdvancedInsightRequest advancedInsightRequest)
                                                 throws VonageResponseParseException,
VonageClientException

Perform an Advanced Insight Request with a AdvancedInsightRequest.

Parameters:

advancedInsightRequest - A request object containing the details of the request to make.

Returns:

A AdvancedInsightResponse representing the response from the Vonage Number Insight API.

Throws:

VonageResponseParseException - if the response from the API could not be parsed.

VonageClientException - if there was a problem with the Vonage request or response objects.