NAME

Filter::DisposableEmail - Interface to the DEAfilter RESTful API.

VERSION

Version 0.02

DESCRIPTION

This module helps you filter Disposable Email Addresses. It uses DEAfilter RESTful API and no guarantee is provided by any means.

CONSTRUCTOR

The only parameter that is required is the API key. You can get one here:

http://www.deafilter.com/register.php

    use strict; use warnings;
    use Filter::DisposableEmail;

    my ($key, $filter);
    $key    = 'Your_API_Key';
    $filter = Filter::DisposableEmail->new($key);
    
    #or
    $filter = Filter::DisposableEmail->new(key => $key);

METHOD

isDisposable()

Return 1/0 depending whether the given email address is disposable or not. This simply rely on DEAfilter API functionality. Because of it's nature, you may sometimes get false alarm.

    use strict; use warnings;
    use Filter::DisposableEmail;

    my $key    = 'Your_API_Key';
    my $filter = Filter::DisposableEmail->new($key);
    print "Yes it is.\n" if $filter->isDisposable(email => 'bill@microsoft.com');

AUTHOR

Mohammad S Anwar, <mohammad.anwar at yahoo.com>

BUGS

Please report any bugs or feature requests to bug-filter-disposableemail at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Filter-DisposableEmail. I will be notified and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Filter::DisposableEmail

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Filter-DisposableEmail

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Filter-DisposableEmail

• CPAN Ratings

  http://cpanratings.perl.org/d/Filter-DisposableEmail

• Search CPAN

  http://search.cpan.org/dist/Filter-DisposableEmail/

LICENSE AND COPYRIGHT

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

DEAFilter API itself is distributed under the terms of the Gnu GPLv3 licence.

DISCLAIMER

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.