Class: Mandrill::Whitelists

Inherits:
Object
  • Object
show all
Defined in:
lib/mandrill/api.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(master) ⇒ Whitelists

Returns a new instance of Whitelists.



1031
1032
1033
# File 'lib/mandrill/api.rb', line 1031

def initialize(master)
    @master = master
end

Instance Attribute Details

#masterObject

Returns the value of attribute master.



1029
1030
1031
# File 'lib/mandrill/api.rb', line 1029

def master
  @master
end

Instance Method Details

#add(email) ⇒ Hash

Adds an email to your email rejection whitelist. If the address is currently on your blacklist, that blacklist entry will be removed automatically.

Parameters:

  • email (String)

    an email address to add to the whitelist

Returns:

  • (Hash)

    a status object containing the address and the result of the operation

    • String

      email the email address you provided

    • Boolean

      whether the operation succeeded



1040
1041
1042
1043
# File 'lib/mandrill/api.rb', line 1040

def add(email)
    _params = {:email => email}
    return @master.call 'whitelists/add', _params
end

#delete(email) ⇒ Hash

Removes an email address from the whitelist.

Parameters:

  • email (String)

    the email address to remove from the whitelist

Returns:

  • (Hash)

    a status object containing the address and whether the deletion succeeded

    • String

      email the email address that was removed from the blacklist

    • Boolean

      deleted whether the address was deleted successfully



1062
1063
1064
1065
# File 'lib/mandrill/api.rb', line 1062

def delete(email)
    _params = {:email => email}
    return @master.call 'whitelists/delete', _params
end

#list(email = nil) ⇒ Array

Retrieves your email rejection whitelist. You can provide an email address or search prefix to limit the results. Returns up to 1000 results.

Parameters:

  • email (String) (defaults to: nil)

    an optional email address or prefix to search by

Returns:

  • (Array)

    up to 1000 whitelist entries

    • Hash

      return[] the information for each whitelist entry

      - [String] email the email that is whitelisted
      - [String] detail a description of why the email was whitelisted
      - [String] created_at when the email was added to the whitelist
      


1052
1053
1054
1055
# File 'lib/mandrill/api.rb', line 1052

def list(email=nil)
    _params = {:email => email}
    return @master.call 'whitelists/list', _params
end