vonage 7.25.0 → 7.27.0

data/lib/vonage/network_authentication/server_authentication.rb

@@ -0,0 +1,47 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class NetworkAuthentication::ServerAuthentication < Namespace
+    extend T::Sig
+
+    self.authentication = BearerToken
+
+    self.host = :vonage_host
+
+    self.request_headers['Content-Type'] = 'application/x-www-form-urlencoded'
+
+    def token(purpose:, api_scope:, login_hint:, **params)
+      auth_req_id = bc_authorize(
+        purpose: purpose,
+        api_scope: api_scope,
+        login_hint: login_hint
+      ).auth_req_id
+
+      request_access_token(auth_req_id: auth_req_id).access_token
+    end
+
+    def bc_authorize(purpose:, api_scope:, login_hint:)
+      scope = "openid dpv:#{purpose}##{api_scope}"
+      request(
+        "/oauth2/bc-authorize",
+        params: {
+          scope: scope,
+          login_hint: login_hint
+        },
+        type: Post
+      )
+    end
+
+    def request_access_token(auth_req_id:)
+      request(
+        "/oauth2/token",
+        params: {
+          grant_type: 'urn:openid:params:grant-type:ciba',
+          auth_req_id: auth_req_id
+        },
+        type: Post
+      )
+    end
+  end
+end

data/lib/vonage/network_authentication.rb

@@ -0,0 +1,22 @@
+# typed: true
+# frozen_string_literal: true
+
+module Vonage
+  class NetworkAuthentication < AbstractAuthentication
+    def update(object, data)
+      return unless object.is_a?(Net::HTTPRequest)
+
+      token = self.public_send(data[:auth_flow]).token(**data)
+
+      object['Authorization'] = 'Bearer ' + token
+    end
+
+    def client_authentication
+      @client_authentication ||= ClientAuthentication.new(@config)
+    end
+
+    def server_authentication
+      @server_authentication ||= ServerAuthentication.new(@config)
+    end
+  end
+end

data/lib/vonage/network_number_verification.rb

@@ -0,0 +1,92 @@
+# typed: strict
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class NetworkNumberVerification < Namespace
+    extend T::Sig
+    include Keys
+
+    self.authentication = NetworkAuthentication
+
+    self.host = :vonage_host
+
+    self.request_body = JSON
+
+    # Verifies if the specified phone number (plain text or hashed format) matches the one that the user is currently using.
+    #
+    # @example
+    #   response = client.network_number_verification.verify(
+    #     phone_number: '+447900000000',
+    #     auth_data: {
+    #       oidc_auth_code: '0dadaeb4-7c79-4d39-b4b0-5a6cc08bf537',
+    #       redirect_uri: 'https://example.com/callback'
+    #     }
+    #   )
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @param [required, Hash] :auth_data A hash of authentication data required for the client token request. Must contain the following keys:
+    # @option auth_data [required, String] :oidc_auth_code The OIDC auth code.
+    # @option auth_data [required, String] :redirect_uri The redirect URI.
+    # @see https://developer.vonage.com/en/getting-started-network/authentication#client-authentication-flow
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/number-verification#verifyNumberVerification
+    #
+    sig { params(phone_number: String, auth_data: Hash).returns(Vonage::Response) }
+    def verify(phone_number:, auth_data:)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+      raise ArgumentError.new("`auth_data` must contain key `:oidc_auth_code`") unless auth_data.has_key?(:oidc_auth_code)
+      raise ArgumentError.new("`auth_data[:oidc_auth_code]` must be a String") unless auth_data[:oidc_auth_code].is_a?(String)
+      raise ArgumentError.new("`auth_data` must contain key `:redirect_uri`") unless auth_data.has_key?(:redirect_uri)
+      raise ArgumentError.new("`auth_data[:redirect_uri]` must be a String") unless auth_data[:redirect_uri].is_a?(String)
+
+      params = {phone_number: phone_number}
+
+      request(
+        '/camara/number-verification/v031/verify',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          oidc_auth_code: auth_data[:oidc_auth_code],
+          redirect_uri: auth_data[:redirect_uri],
+          auth_flow: :client_authentication
+        }
+      )
+    end
+
+    # Creates a URL for a client-side OIDC request.
+    #
+    # @example
+    #   response = client.network_number_verification.generate_oidc_uri(
+    #     phone_number: '+447900000000',
+    #     redirect_uri: 'https://example.com/callback'
+    #   )
+    #
+    # @param [required, String] :phone_number The phone number that will be checked during the verification request.
+    #
+    # @param [required, String] :redirect_uri The URI that will receive the callback containing the OIDC auth code.
+    #
+    # @param [required, String] :state A string that you can use for tracking. 
+    #   Used to set a unique identifier for each access token you generate.
+    #
+    # @return [String]
+    #
+    # @see https://developer.vonage.com/en/getting-started-network/authentication#1-make-an-oidc-request
+    sig { params(phone_number: String, redirect_uri: String, state: String).returns(String) }
+    def generate_oidc_uri(phone_number:, redirect_uri:, state:)
+      params = {
+        purpose: 'FraudPreventionAndDetection',
+        api_scope: 'number-verification-verify-read',
+        login_hint: phone_number,
+        redirect_uri: redirect_uri,
+        state: state
+      }
+
+      Vonage::NetworkAuthentication::ClientAuthentication.new(@config).generate_oidc_uri(**params)
+    end
+  end
+end

data/lib/vonage/network_sim_swap.rb

@@ -0,0 +1,84 @@
+# typed: strict
+# frozen_string_literal: true
+require 'phonelib'
+
+module Vonage
+  class NetworkSIMSwap < Namespace
+    extend T::Sig
+    include Keys
+
+    self.authentication = NetworkAuthentication
+
+    self.host = :vonage_host
+
+    self.request_body = JSON
+
+    # Check if SIM swap has been performed during a past period.
+    #
+    # @example
+    #   response = client.network_sim_swap.check(phone_number: '+447900000000')
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @param [optional, Integer] :max_age Period in hours to be checked for SIM swap
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/sim-swap#checkSimSwap
+    #
+    sig { params(phone_number: String, max_age: T.nilable(Integer)).returns(Vonage::Response) }
+    def check(phone_number:, max_age: nil)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+      if max_age
+        raise ArgumentError.new("`max_age` must between 1 and 2400") unless max_age.between?(1, 2400)
+      end
+
+      params = {phone_number: phone_number}
+      params[:max_age] = max_age if max_age
+
+      request(
+        '/camara/sim-swap/v040/check',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          login_hint: phone_number,
+          purpose: 'FraudPreventionAndDetection',
+          api_scope: 'check-sim-swap',
+          auth_flow: :server_authentication
+        }
+      )
+    end
+
+    # Get timestamp of last MSISDN <-> IMSI pairing change for a mobile user account provided with MSIDN.
+    #
+    # @example
+    #   response = client.network_sim_swap.retrieve_date(phone_number: '+447900000000')
+    #
+    # @param [required, String] :phone_number The phone number to check, in the E.164 format, prepended with a `+`.
+    #
+    # @return [Response]
+    #
+    # @see https://developer.vonage.com/en/api/camara/sim-swap#retrieveSimSwapDate
+    #
+    sig { params(phone_number: String).returns(Vonage::Response) }
+    def retrieve_date(phone_number:)
+      raise ArgumentError.new("`phone_number` must be in E.164 format") unless Phonelib.parse(phone_number).valid?
+      raise ArgumentError.new("`phone_number` must be prepended with a `+`") unless phone_number.start_with?('+')
+
+      params = {phone_number: phone_number}
+
+      request(
+        '/camara/sim-swap/v040/retrieve-date',
+        params: camelcase(params),
+        type: Post,
+        auth_data: {
+          login_hint: phone_number,
+          purpose: 'FraudPreventionAndDetection',
+          api_scope: 'retrieve-sim-swap-date',
+          auth_flow: :server_authentication
+        }
+      )
+    end
+  end
+end

data/lib/vonage/numbers.rb

@@ -17,6 +17,8 @@ module Vonage
     #     puts "#{item.msisdn} #{item.country} #{item.type}"
     #   end
     #
+    # @param [Hash] params
+    #
     # @option params [String] :application_id
     #   The application that you want to return the numbers for.
     #
@@ -47,8 +49,6 @@ module Vonage
     #   Set this to `true` to auto-advance through all the pages in the record
     #   and collect all the data. The default is `false`.
     #
-    # @param [Hash] params
-    #
     # @return [ListResponse]
     #
     # @see https://developer.nexmo.com/api/developer/numbers#getOwnedNumbers
@@ -65,6 +65,8 @@ module Vonage
     #     puts "#{item.msisdn} #{item.type} #{item.cost}"
     #   end
     #
+    # @param [Hash] params
+    #
     # @option params [required, String] :country
     #   The two character country code in ISO 3166-1 alpha-2 format.
     #
@@ -82,7 +84,7 @@ module Vonage
     #   - `2` - Search for numbers that end with **:pattern**
     #
     # @option params [String] :features
-    #   Available features are `SMS` and `VOICE`.
+    #   Available features are `SMS`, `MMS`, and `VOICE`.
     #   To look for numbers that support both, use a comma-separated value: `SMS,VOICE`.
     #
     # @option params [Integer] :size
@@ -95,8 +97,6 @@ module Vonage
     #   Set this to `true` to auto-advance through all the pages in the record
     #   and collect all the data. The default is `false`.
     #
-    # @param [Hash] params
-    #
     # @return [ListResponse]
     #
     # @see https://developer.nexmo.com/api/developer/numbers#getAvailableNumbers
@@ -110,6 +110,8 @@ module Vonage
     # @example
     #   response = client.numbers.buy(country: 'GB', msisdn: '447700900000')
     #
+    # @param [Hash] params
+    #
     # @option params [required, String] :country
     #   The two character country code in ISO 3166-1 alpha-2 format.
     #
@@ -120,8 +122,6 @@ module Vonage
     #   If you'd like to perform an action on a subaccount, provide the `api_key` of that account here.
     #   If you'd like to perform an action on your own account, you do not need to provide this field.
     #
-    # @param [Hash] params
-    #
     # @return [Response]
     #
     # @see https://developer.nexmo.com/api/developer/numbers#buyANumber
@@ -140,6 +140,8 @@ module Vonage
     # @example
     #   response = client.numbers.cancel(country: 'GB', msisdn: '447700900000')
     #
+    # @param [Hash] params
+    #
     # @option params [required, String] :country
     #   The two character country code in ISO 3166-1 alpha-2 format.
     #
@@ -150,8 +152,6 @@ module Vonage
     #   If you'd like to perform an action on a subaccount, provide the `api_key` of that account here.
     #   If you'd like to perform an action on your own account, you do not need to provide this field.
     #
-    # @param [Hash] params
-    #
     # @return [Response]
     #
     # @see https://developer.nexmo.com/api/developer/numbers#cancelANumber
@@ -177,6 +177,8 @@ module Vonage
     #
     #   response = client.numbers.update(params)
     #
+    # @param [Hash] params
+    #
     # @option params [required, String] :country
     #   The two character country code in ISO 3166-1 alpha-2 format.
     #
@@ -203,8 +205,6 @@ module Vonage
     # @option params [String] :voice_status_callback
     #   A webhook URI for Vonage to send a request to when a call ends.
     #
-    # @param [Hash] params
-    #
     # @return [Response]
     #
     # @see https://developer.nexmo.com/api/developer/numbers#updateANumber

data/lib/vonage/proactive_connect/events.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Find all events
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.events.list
     #
@@ -59,6 +61,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#eventsFindAll
     #
     def list(**params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       path = "/v0.1/bulk/events"
       path += "?#{Params.encode(params)}" unless params.empty?
 

data/lib/vonage/proactive_connect/item.rb

@@ -13,6 +13,8 @@ module Vonage
 
     # Create a list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.create(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', data: {name: 'Joe Bloggs', email: 'joe@email.com'})
     #
@@ -25,6 +27,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsCreate
     #
     def create(list_id:, data:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       raise ArgumentError.new(":data must be a Hash") unless data.is_a? Hash
       request(
         "/v0.1/bulk/lists/#{list_id}/items",
@@ -35,6 +38,8 @@ module Vonage
 
     # Get list item by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.find(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', item_id: 'd97ebf20-e4de-4e50-921a-7bb4dceb373a')
     #
@@ -47,11 +52,14 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsGet
     #
     def find(list_id:, item_id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request("/v0.1/bulk/lists/#{list_id}/items/#{item_id}")
     end
 
     # Update list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.create(
     #     list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865',
@@ -73,6 +81,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsUpdate
     #
     def update(list_id:, item_id:, data:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       raise ArgumentError.new(":data must be a Hash") unless data.is_a? Hash
       request(
         "/v0.1/bulk/lists/#{list_id}/items/#{item_id}",
@@ -83,6 +92,8 @@ module Vonage
 
     #  Delete list item
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.item.delete(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', item_id: 'd97ebf20-e4de-4e50-921a-7bb4dceb373a')
     #
@@ -95,6 +106,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsDelete
     #
     def delete(list_id:, item_id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{list_id}/items/#{item_id}",
         type: Delete

data/lib/vonage/proactive_connect/items.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Find all list items
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.list(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -29,6 +31,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsFindAll
     #
     def list(list_id:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       path = "/v0.1/bulk/lists/#{list_id}/items"
       path += "?#{Params.encode(params)}" unless params.empty?
 
@@ -37,6 +40,8 @@ module Vonage
 
     # Download list items as a CSV file format
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.download_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -64,6 +69,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsDownload
     #
     def download_csv(list_id:, order: 'asc', **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       response = request("/v0.1/bulk/lists/#{list_id}/items/download?order=#{order}", response_class: FileResponse)
 
       response.filename = params[:filename] if params[:filename]
@@ -74,6 +80,8 @@ module Vonage
 
     # Import list items from a CSV file
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.items.upload_csv(list_id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865', filepath: '/files/import.csv')
     #
@@ -96,6 +104,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#itemsImport
     #
     def upload_csv(list_id:, filepath:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       pn = Pathname.new(filepath)
       raise ArgumentError, ':filepath not for a file' unless pn.file?
       raise ArgumentError, 'file at :filepath not readable' unless pn.readable?

data/lib/vonage/proactive_connect/list.rb

@@ -13,6 +13,8 @@ module Vonage
 
     # Create list
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.create(name: 'List Number 1')
     #
@@ -47,6 +49,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsCreate
     #
     def create(name:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists",
         params: params.merge({ name: name }),
@@ -56,6 +59,8 @@ module Vonage
 
     # Get list by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.find(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -65,11 +70,14 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsGet
     #
     def find(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request("/v0.1/bulk/lists/#{id}")
     end
 
     # Update list
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.update(name: 'List Number 1')
     #
@@ -107,6 +115,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsUpdate
     #
     def update(id:, name:, **params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}",
         params: params.merge({ name: name }),
@@ -116,6 +125,8 @@ module Vonage
 
     # Delete a list by id
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.delete(id: '74ea1ecf-06c9-4072-a285-61677bd353e8')
     #
@@ -125,6 +136,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsDelete
     #
     def delete(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}",
         type: Delete
@@ -133,6 +145,8 @@ module Vonage
 
     # Clear list by deleting all items
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.clear_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -142,6 +156,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsClear
     #
     def clear_items(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}/clear",
         type: Post
@@ -150,6 +165,8 @@ module Vonage
 
     # Fetch and replace all items from datasource
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.list.fetch_and_replace_items(id: 'e546eebe-8e23-4e4d-bb7c-29d4700c9865')
     #
@@ -159,6 +176,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsFetch
     #
     def fetch_and_replace_items(id:)
+      logger.info('This method is deprecated and will be removed in a future release.')
       request(
         "/v0.1/bulk/lists/#{id}/fetch",
         type: Post

data/lib/vonage/proactive_connect/lists.rb

@@ -11,6 +11,8 @@ module Vonage
 
     # Find all lists
     #
+    # @deprecated
+    #
     # @example
     #   response = proactive_connect.lists.list
     #
@@ -26,6 +28,7 @@ module Vonage
     # @see https://developer.vonage.com/en/api/proactive-connect#listsFindAll
     #
     def list(**params)
+      logger.info('This method is deprecated and will be removed in a future release.')
       path = "/v0.1/bulk/lists"
       path += "?#{Params.encode(params)}" unless params.empty?
 

data/lib/vonage/proactive_connect.rb

@@ -5,28 +5,38 @@ module Vonage
   class ProactiveConnect < Namespace
     extend T::Sig
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Lists)) }
     def lists
+      logger.info('This method is deprecated and will be removed in a future release.')
       @lists ||= Lists.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::List)) }
     def list
+      logger.info('This method is deprecated and will be removed in a future release.')
       @list ||= List.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Items)) }
     def items
+      logger.info('This method is deprecated and will be removed in a future release.')
       @items ||= Items.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Item)) }
     def item
+      logger.info('This method is deprecated and will be removed in a future release.')
       @item ||= Item.new(@config)
     end
 
+    # @deprecated
     sig { returns(T.nilable(Vonage::ProactiveConnect::Events)) }
     def events
+      logger.info('This method is deprecated and will be removed in a future release.')
       @events ||= Events.new(@config)
     end
   end

data/lib/vonage/verify2/start_verification_options.rb

@@ -5,7 +5,7 @@ module Vonage
   class Verify2::StartVerificationOptions
     VALID_OPTS = [:locale, :channel_timeout, :client_ref, :code_length, :code, :fraud_check].freeze
 
-    MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT = [60, 900]
+    MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT = [15, 900]
 
     MIN_CODE_LENGTH, MAX_CODE_LENGTH = [4, 10]
 
@@ -22,6 +22,7 @@ module Vonage
     end
 
     def channel_timeout=(channel_timeout)
+      raise ArgumentError, "Invalid 'channel_timeout' #{channel_timeout}. Must be an integer" unless channel_timeout.is_a?(Integer)
       unless channel_timeout.between?(MIN_CHANNEL_TIMEOUT, MAX_CHANNEL_TIMEOUT)
         raise ArgumentError, "Invalid 'channel_timeout' #{channel_timeout}. Must be between #{MIN_CHANNEL_TIMEOUT} and #{MAX_CHANNEL_TIMEOUT} (inclusive)"
       end

data/lib/vonage/version.rb

@@ -1,5 +1,5 @@
 # typed: strong
 
 module Vonage
-  VERSION = '7.25.0'
+  VERSION = '7.27.0'
 end

data/lib/vonage/voice/actions/connect.rb

@@ -107,9 +107,13 @@ module Vonage
     end
 
     def verify_event_url
-      uri = URI.parse(self.eventUrl)
+      unless self.eventUrl.is_a?(Array) && self.eventUrl.length == 1 && self.eventUrl[0].is_a?(String)
+        raise ClientError.new("Expected 'eventUrl' parameter to be an Array containing a single string item")
+      end
+
+      uri = URI.parse(self.eventUrl[0])
 
-      raise ClientError.new("Invalid 'eventUrl' value, must be a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
+      raise ClientError.new("Invalid 'eventUrl' value, array must contain a valid URL") unless uri.kind_of?(URI::HTTP) || uri.kind_of?(URI::HTTPS)
 
       self.eventUrl
     end
@@ -209,6 +213,7 @@ module Vonage
       }
 
       hash.merge!(headers: endpoint_attrs[:headers]) if endpoint_attrs[:headers]
+      hash.merge!(standardHeaders: endpoint_attrs[:standardHeaders]) if endpoint_attrs[:standardHeaders]
 
       hash
     end