com.nexmo.client.verify

Class VerifyClient

java.lang.Object

com.nexmo.client.AbstractClient

com.nexmo.client.verify.VerifyClient

public class VerifyClient
extends AbstractClient

A client for talking to the Nexmo Verify API. The standard way to obtain an instance of this class is to use NexmoClient.getVerifyClient().

Send a verification request with a call to verify, confirm the code entered by the user with check, and search in-progress or completed verification requests with search

More information on method parameters can be found at Nexmo website: https://docs.nexmo.com/verify

Field Summary

Fields inherited from class com.nexmo.client.AbstractClient

httpWrapper

Constructor Summary

Constructors

Constructor and Description
VerifyClient(HttpWrapper httpWrapper) Constructor.

Method Summary

Modifier and Type	Method and Description
void	advanceVerification(java.lang.String requestId) Advance a current verification request to the next stage in the process.
void	cancelVerification(java.lang.String requestId) Cancel a current verification request.
CheckResult	check(java.lang.String requestId, java.lang.String code) Validate a code provided by a user in response to a call from verify.
CheckResult	check(java.lang.String requestId, java.lang.String code, java.lang.String ipAddress) Validate a code provided by a user in response to a call from verify.
SearchResult[]	search(java.lang.String... requestIds) Search for a previous verification request.
SearchResult	search(java.lang.String requestId) Search for a previous verification request.
VerifyResult	verify(java.lang.String number, java.lang.String brand) Send a verification request to a phone number.
VerifyResult	verify(java.lang.String number, java.lang.String brand, java.lang.String from) Send a verification request to a phone number.
VerifyResult	verify(java.lang.String number, java.lang.String brand, java.lang.String from, int length, java.util.Locale locale) Send a verification request to a phone number.
VerifyResult	verify(java.lang.String number, java.lang.String brand, java.lang.String from, int length, java.util.Locale locale, VerifyRequest.LineType type) Send a verification request to a phone number.
VerifyResult	verify(VerifyRequest request) Send a verification request to a phone number.

Methods inherited from class java.lang.Object

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

Constructor Detail

VerifyClient

public VerifyClient(HttpWrapper httpWrapper)

Constructor.

Parameters:

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

Method Detail

verify

public VerifyResult verify(java.lang.String number,
                           java.lang.String brand)
                    throws java.io.IOException,
                           NexmoClientException

Send a verification request to a phone number.

Parameters:

number - (required) The recipient's phone number in E.164 format.

brand - (required) The name of the company or app to be verified for. Must not be longer than 18 characters.

Returns:

a VerifyResult representing the response received from the Verify API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

verify

public VerifyResult verify(java.lang.String number,
                           java.lang.String brand,
                           java.lang.String from)
                    throws java.io.IOException,
                           NexmoClientException

Send a verification request to a phone number.

Parameters:

number - (required) The recipient's phone number in E.164 format.

brand - (required) The name of the company or app to be verified for. Must not be longer than 18 characters.

from - (optional The Nexmo number to use as the sender for the verification SMS message and calls, in E.164 format.

Returns:

a VerifyResult representing the response received from the Verify API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

verify

public VerifyResult verify(java.lang.String number,
                           java.lang.String brand,
                           java.lang.String from,
                           int length,
                           java.util.Locale locale)
                    throws java.io.IOException,
                           NexmoClientException

Send a verification request to a phone number.

Parameters:

number - (required) The recipient's phone number in E.164 format.

brand - (required) The name of the company or app to be verified for. Must not be longer than 18 characters.

from - (optional The Nexmo number to use as the sender for the verification SMS message and calls, in E.164 format.

length - (optional) The length of the verification code to be sent to the user. Must be either 4 or 6. Use -1 to use the default value.

locale - (optional) Override the default locale used for verification. By default the locale is determined from the country code included in number

Returns:

a VerifyResult representing the response received from the Verify API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

verify

public VerifyResult verify(java.lang.String number,
                           java.lang.String brand,
                           java.lang.String from,
                           int length,
                           java.util.Locale locale,
                           VerifyRequest.LineType type)
                    throws java.io.IOException,
                           NexmoClientException

Send a verification request to a phone number.

Parameters:

number - (required) The recipient's phone number in E.164 format.

brand - (required) The name of the company or app to be verified for. Must not be longer than 18 characters.

from - (optional The Nexmo number to use as the sender for the verification SMS message and calls, in E.164 format.

length - (optional) The length of the verification code to be sent to the user. Must be either 4 or 6. Use -1 to use the default value.

locale - (optional) Override the default locale used for verification. By default the locale is determined from the country code included in number

type - (optional) If provided, restrict the verification to the specified network type. Contact support@nexmo.com to enable this feature.

Returns:

a VerifyResult representing the response received from the Verify API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

verify

public VerifyResult verify(VerifyRequest request)
                    throws java.io.IOException,
                           NexmoClientException

Send a verification request to a phone number.

Throws:

java.io.IOException

NexmoClientException

check

public CheckResult check(java.lang.String requestId,
                         java.lang.String code)
                  throws java.io.IOException,
                         NexmoClientException

Validate a code provided by a user in response to a call from verify.

Parameters:

requestId - (required) The requestId returned by the verify call.

code - (required) The code entered by the user.

Returns:

a CheckResult representing the response received from the API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

check

public CheckResult check(java.lang.String requestId,
                         java.lang.String code,
                         java.lang.String ipAddress)
                  throws java.io.IOException,
                         NexmoClientException

Validate a code provided by a user in response to a call from verify.

Parameters:

requestId - (required) The requestId returned by the verify call.

code - (required) The code entered by the user.

ipAddress - (optional) The IP address obtained from the HTTP request made when the user entered their code.

Returns:

a CheckResult representing the response received from the API call.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

search

public SearchResult search(java.lang.String requestId)
                    throws java.io.IOException,
                           NexmoClientException

Search for a previous verification request.

Parameters:

requestId - The requestId of a single Verify request to be looked up.

Returns:

A SearchResult containing the details of the Verify request that was looked up, or null if no record was found.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

search

public SearchResult[] search(java.lang.String... requestIds)
                      throws java.io.IOException,
                             NexmoClientException

Search for a previous verification request.

Parameters:

requestIds - The requestIds of Verify requests to be looked up.

Returns:

An array SearchResult for each record that was found.

Throws:

java.io.IOException - if a network error occurred contacting the Nexmo Verify API.

NexmoClientException - if there was a problem with the Nexmo request or response objects.

advanceVerification

public void advanceVerification(java.lang.String requestId)
                         throws java.io.IOException,
                                NexmoClientException

Advance a current verification request to the next stage in the process.

Parameters:

requestId - The requestId of the ongoing verification request.

Throws:

java.io.IOException - If an IO error occurred while making the request.

NexmoClientException - If the request failed for some reason.

cancelVerification

public void cancelVerification(java.lang.String requestId)
                        throws java.io.IOException,
                               NexmoClientException

Cancel a current verification request.

Parameters:

requestId - The requestId of the ongoing verification request.

Throws:

java.io.IOException - If an IO error occurred while making the request.

NexmoClientException - If the request failed for some reason.