Sha256: 19103d1d57b2bf36fffee76bdda51cebc74639301560a3afb2f00b5fd1c541fd
Contents?: true
Size: 1.61 KB
Versions: 7
Compression:
Stored size: 1.61 KB
Contents
require 'mailgun/exceptions/exceptions'
module Mailgun
# Mailgun::Address is a simple interface to the Email Validation API.
class Address
# @param [String] api_key Mailgun API - public key
def initialize(api_key = "")
if api_key == "" then
fail ParameterError.new('Public API key is required for Mailgun::Address.initialize()', nil)
end
@api_key = api_key
@client = Mailgun::Client.new(api_key = api_key)
end
# Given an arbitrary address, validates it based on defined checks.
#
# @param [String] address Email address to validate (max 512 chars.)
def validate(address)
res = @client.get "address/validate", {:address => address}
return res.to_h!
end
# Parses a delimiter separated list of email addresses into two lists:
# parsed addresses and unparsable portions. The parsed addresses are a
# list of addresses that are syntactically valid (and optionally have
# DNS and ESP specific grammar checks) the unparsable list is a list
# of characters sequences that the parser was not able to understand.
# These often align with invalid email addresses, but not always.
# Delimiter characters are comma (,) and semicolon (;).
#
# @param [Array] addresses Addresses to parse
# @param [TrueClass|FalseClass] syntax_only Perform only syntax checks
def parse(addresses, syntax_only = true)
validate_addrs = addresses.join(";")
res = @client.get "address/parse", {:addresses => validate_addrs,
:syntax_only => syntax_only.to_s}
return res.to_h!
end
end
end
Version data entries
7 entries across 7 versions & 2 rubygems