Class: TelesignEnterprise::VerifyClient

Inherits:
Telesign::RestClient
  • Object
show all
Defined in:
lib/telesignenterprise/verify.rb

Overview

The Verify API delivers phone-based verification and two-factor authentication using a time-based, one-time passcode sent via SMS message and Voice call.

Defined Under Namespace

Classes: OmniVerifyClient

Instance Method Summary collapse

Constructor Details

#initialize(customer_id, api_key, rest_endpoint: 'https://rest-ww.telesign.com', timeout: nil, source: 'ruby_telesign_enterprise', sdk_version_origin: '2.5.0', sdk_version_dependency: Gem.loaded_specs['telesign'].version) ⇒ VerifyClient

Returns a new instance of VerifyClient.



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# File 'lib/telesignenterprise/verify.rb', line 15

def initialize(customer_id,
               api_key,
               rest_endpoint: 'https://rest-ww.telesign.com',
               timeout: nil,
               source: 'ruby_telesign_enterprise',
               sdk_version_origin: '2.5.0',
               sdk_version_dependency: Gem.loaded_specs['telesign'].version)

  super(customer_id,
        api_key,
        rest_endpoint: rest_endpoint,
        timeout: timeout,
        source: source,
        sdk_version_origin: sdk_version_origin,
        sdk_version_dependency: sdk_version_dependency)
end

Instance Method Details

#completion(reference_id, **params) ⇒ Object

Notifies TeleSign that a verification was successfully delivered to the user in order to help improve the quality of message delivery routes.

See developer.telesign.com/docs/completion-service-for-verify-products for detailed API documentation.



103
104
105
106
# File 'lib/telesignenterprise/verify.rb', line 103

def completion(reference_id, **params)
  self.put(VERIFY_COMPLETION_RESOURCE % {:reference_id => reference_id},
           **params)
end

#create_verification_process(phone_number, **params) ⇒ Object

Use this action to create a verification process for the specified phone number.

See developer.telesign.com/enterprise/reference/createverificationprocess for detailed API documentation.



111
112
113
114
# File 'lib/telesignenterprise/verify.rb', line 111

def create_verification_process(phone_number, **params)
  omni_verify = OmniVerifyClient.new(@customer_id, @api_key, rest_endpoint: @rest_endpoint)
  omni_verify.create_verification_process(phone_number, **params)
end

#smart(phone_number, ucid, **params) ⇒ Object

The Smart Verify web service simplifies the process of verifying user identity by integrating several TeleSign web services into a single API call. This eliminates the need for you to make multiple calls to the TeleSign Verify resource.

See developer.telesign.com/docs/rest_api-smart-verify for detailed API documentation.



84
85
86
87
88
89
# File 'lib/telesignenterprise/verify.rb', line 84

def smart(phone_number, ucid, **params)
  self.post(VERIFY_SMART_RESOURCE,
            phone_number: phone_number,
            ucid: ucid,
            **params)
end

#sms(phone_number, **params) ⇒ Object

The SMS Verify API delivers phone-based verification and two-factor authentication using a time-based, one-time passcode sent over SMS.

See developer.telesign.com/docs/rest_api-verify-sms for detailed API documentation.



63
64
65
66
67
# File 'lib/telesignenterprise/verify.rb', line 63

def sms(phone_number, **params)
  self.post(VERIFY_SMS_RESOURCE,
            phone_number: phone_number,
            **params)
end

#status(reference_id, **params) ⇒ Object

Retrieves the verification result for any verify resource.

See developer.telesign.com/docs/rest_api-verify-transaction-callback for detailed API documentation.



94
95
96
97
# File 'lib/telesignenterprise/verify.rb', line 94

def status(reference_id, **params)
  self.get(VERIFY_STATUS_RESOURCE % {:reference_id => reference_id},
           **params)
end

#voice(phone_number, **params) ⇒ Object

The Voice Verify API delivers patented phone-based verification and two-factor authentication using a one-time passcode sent over voice message.

See developer.telesign.com/docs/rest_api-verify-call for detailed API documentation.



73
74
75
76
77
# File 'lib/telesignenterprise/verify.rb', line 73

def voice(phone_number, **params)
  self.post(VERIFY_VOICE_RESOURCE,
            phone_number: phone_number,
            **params)
end