NAME

WebService::AbuseIPDB::BlacklistResponse - Specific class for responses to blacklist method

SYNOPSIS

The blacklist method of WebService::AbuseIPDB will return an object of this class. It is a subclass of the generic WebService::AbuseIPDB::Response class.

use WebService::AbuseIPDB;

my $ipdb = WebService::AbuseIPDB->new (key => 'abc123...');
my $res = $ipdb->blacklist (limit => 5);
unless ($res->successful) {
    for my $err (@{$res->errors}) {
        warn "Error $err->{status}: $err->{detail}\n";
    }
    die "Cannot continue.\n";
}
my $when = $res->as_at;
my @list = $res->list;
print "As at $when\n";
for my $item (@list) {
    printf "%s has a score of %i\n",
        $item->ip, $item->score;
}

METHODS

The new, successful and errors methods are inherited from WebService::AbuseIPDB::Response. All other methods are accessors as listed here.

as_at

Returns the time at which this list was generated in the format YYYY-MM-DDTHH:MM:SS+HH:MM as a scalar string.

list

Returns the payload as an array of WebService::AbuseIPDB::BlacklistMember objects

SEE ALSO

WebService::AbuseIPDB for general use of the client, WebService::AbuseIPDB::Response for the parent class and Version 2 of the AbuseIPDB API for API details/restrictions.

LICENCE AND COPYRIGHT

Copyright © 2020 Pete Houston

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 dated June, 1991 or at your option any later version.

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. See the GNU General Public License for more details.

A copy of the GNU General Public License is available in the source tree; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA