# NAME

[Net::RDAP](https://metacpan.org/pod/Net::RDAP) - an interface to the Registration Data Access Protocol
(RDAP).

# SYNOPSIS

        use Net::RDAP;

        my $rdap = Net::RDAP->new;

        # get domain info:
        $object = $rdap->domain(Net::DNS::Domain->new('example.com'));

        # get info about IP addresses/ranges:
        $object = $rdap->ip(Net::IP->new('192.168.0.1'));
        $object = $rdap->ip(Net::IP->new('2001:DB8::/32'));

        # get info about AS numbers:
        $object = $rdap->ip(Net::ASN->new(65536));

# DESCRIPTION

[Net::RDAP](https://metacpan.org/pod/Net::RDAP) provides an interface to the Registration Data Access
Protocol (RDAP). RDAP is a replacement for Whois.

[Net::RDAP](https://metacpan.org/pod/Net::RDAP) does all the hard work of determining the correct
server to query ([Net::RDAP::Registry](https://metacpan.org/pod/Net::RDAP::Registry) is an interface to the
IANA registries), querying the server ([Net::RDAP::UA](https://metacpan.org/pod/Net::RDAP::UA) is an
RDAP HTTP user agent), and parsing the response
([Net::RDAP::Object](https://metacpan.org/pod/Net::RDAP::Object) and its submodules provide access to the data
returned by the server).

# METHODS

        $rdap = Net::RDAP->new;

Constructor method, returns a new object.

        $object = $rdap->domain($domain);

This method returns a [Net::RDAP::Object::Domain](https://metacpan.org/pod/Net::RDAP::Object::Domain) object containing
information about the domain name referenced by `$domain`.
`$domain` must be a [Net::DNS::Domain](https://metacpan.org/pod/Net::DNS::Domain) object. The domain may be
either a "forward" domain (such as `example.com`) or a "reverse"
domain (such as `168.192.in-addr.arpa`).

If no RDAP service can be found, or an error occurs, then `undef` is
returned.

        $object = $rdap->ip($ip);

This method returns a [Net::RDAP::Object::IPNetwork](https://metacpan.org/pod/Net::RDAP::Object::IPNetwork) object containing
information about the resource referenced by `$ip`.
`$ip` must be a [Net::IP](https://metacpan.org/pod/Net::IP) object and can represent any of the
following:

- An IPv4 address (e.g. `192.168.0.1`);
- An IPv4 CIDR range (e.g. `192.168.0.1/16`);
- An IPv6 address (e.g. `2001:DB8::42:1`);
- An IPv6 CIDR range (e.g. `2001:DB8::/32`).

If no RDAP service can be found, or an error occurs, then `undef` is
returned.

        $object = $rdap->autnum($autnum);

This method returns a [Net::RDAP::Object::Autnum](https://metacpan.org/pod/Net::RDAP::Object::Autnum) object containing
information about the autonymous system referenced by `$autnum`.
`$autnum` must be a [Net::ASN](https://metacpan.org/pod/Net::ASN) object.

If no RDAP service can be found, or an error occurs, then `undef` is
returned.

        $object = $rdap->fetch($url);
        $object = $rdap->fetch($link);
        $object = $rdap->fetch($object);

The first and second forms of this method fetch the resource
identified by `$url` or `$link` (which must be either a [URI](https://metacpan.org/pod/URI) or
[Net::RDAP::Link](https://metacpan.org/pod/Net::RDAP::Link) object), and return a [Net::RDAP::Object](https://metacpan.org/pod/Net::RDAP::Object)
object (assuming that the resource is a valid RDAP response). This
is used internally by `query()` but is also available for when
you need to directly fetch a resource without using the IANA
registry, such as for nameserver or entity queries.

The third form allows the method to be called on an existing
[Net::RDAP::Object](https://metacpan.org/pod/Net::RDAP::Object). Objects which are embedded inside other
objects (such as the entities and nameservers which are associated
with a domain name) may be truncated or redacted in some way:
this method form allows you to obtain the full object. Here's an
example:

        $rdap = Net::RDAP->new;

        $domain = $rdap->domain(Net::DNS::Domain->new('example.com'));

        foreach my $ns ($domain->nameservers) {
                # $ns is a "stub" object, containing only the host name and a "self" link

                my $nameserver = $rdap->fetch($ns);

                # $nameserver is now fully populated
        }

# HOW TO CONTRIBUTE

[Net::RDAP](https://metacpan.org/pod/Net::RDAP) is a work-in-progress; if you would like to help, the
project is hosted here:

- [https://gitlab.centralnic.com/centralnic/perl-net-rdap](https://gitlab.centralnic.com/centralnic/perl-net-rdap)

# DISTRIBUTION

The [Net::RDAP](https://metacpan.org/pod/Net::RDAP) CPAN distribution contains a large number of#
RDAP-related modules that all work together. They are:

- [Net::RDAP::Base](https://metacpan.org/pod/Net::RDAP::Base), and its submodules:
    - [Net::RDAP::Event](https://metacpan.org/pod/Net::RDAP::Event)
    - [Net::RDAP::ID](https://metacpan.org/pod/Net::RDAP::ID)
    - [Net::RDAP::Object](https://metacpan.org/pod/Net::RDAP::Object), and its submodules:
        - [Net::RDAP::Object::Autnum](https://metacpan.org/pod/Net::RDAP::Object::Autnum)
        - [Net::RDAP::Object::Domain](https://metacpan.org/pod/Net::RDAP::Object::Domain)
        - [Net::RDAP::Object::Entity](https://metacpan.org/pod/Net::RDAP::Object::Entity)
        - [Net::RDAP::Object::IPNetwork](https://metacpan.org/pod/Net::RDAP::Object::IPNetwork)
        - [Net::RDAP::Object::Nameserver](https://metacpan.org/pod/Net::RDAP::Object::Nameserver)
    - [Net::RDAP::Remark](https://metacpan.org/pod/Net::RDAP::Remark), and its submodule:
        - [Net::RDAP::Notice](https://metacpan.org/pod/Net::RDAP::Notice)
- [Net::RDAP::Registry](https://metacpan.org/pod/Net::RDAP::Registry)
- [Net::RDAP::Link](https://metacpan.org/pod/Net::RDAP::Link)
- [Net::RDAP::UA](https://metacpan.org/pod/Net::RDAP::UA)

# DEPENDENCIES

- [DateTime::Format::ISO8601](https://metacpan.org/pod/DateTime::Format::ISO8601)
- [File::Basename](https://metacpan.org/pod/File::Basename)
- [File::Slurp](https://metacpan.org/pod/File::Slurp)
- [File::Spec](https://metacpan.org/pod/File::Spec)
- [File::stat](https://metacpan.org/pod/File::stat)
- [HTTP::Request::Common](https://metacpan.org/pod/HTTP::Request::Common)
- [JSON](https://metacpan.org/pod/JSON)
- [LWP::Protocol::https](https://metacpan.org/pod/LWP::Protocol::https)
- [LWP::UserAgent](https://metacpan.org/pod/LWP::UserAgent)
- [Mozilla::CA](https://metacpan.org/pod/Mozilla::CA)
- [Net::ASN](https://metacpan.org/pod/Net::ASN)
- [Net::DNS](https://metacpan.org/pod/Net::DNS)
- [Net::IP](https://metacpan.org/pod/Net::IP)
- [URI](https://metacpan.org/pod/URI)
- [vCard](https://metacpan.org/pod/vCard)

# REFERENCES

- [https://tools.ietf.org/html/rfc7480](https://tools.ietf.org/html/rfc7480) - HTTP Usage in the Registration
Data Access Protocol (RDAP)
- [https://tools.ietf.org/html/rfc7481](https://tools.ietf.org/html/rfc7481) - Security Services for the
Registration Data Access Protocol (RDAP)
- [https://tools.ietf.org/html/rfc7482](https://tools.ietf.org/html/rfc7482) - Registration Data Access
Protocol (RDAP) Query Format
- [https://tools.ietf.org/html/rfc7483](https://tools.ietf.org/html/rfc7483) - JSON Responses for the
Registration Data Access Protocol (RDAP)
- [https://tools.ietf.org/html/rfc7484](https://tools.ietf.org/html/rfc7484) - Finding the Authoritative
Registration Data (RDAP) Service
- [https://tools.ietf.org/html/rfc8056](https://tools.ietf.org/html/rfc8056) - Extensible Provisioning
Protocol (EPP) and Registration Data Access Protocol (RDAP) Status Mapping
- [https://tools.ietf.org/html/rfc8288](https://tools.ietf.org/html/rfc8288) -  Web Linking

# COPYRIGHT

Copyright 2018 CentralNic Ltd. All rights reserved.

# LICENSE

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted,
provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in
supporting documentation, and that the name of the author not be used
in advertising or publicity pertaining to distribution of the software
without specific prior written permission.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.