Net::RDAP::Registry(3p)

NAME
Net::RDAP::Registry - a module which provides an interface to the IANA RDAP registries.

SYNOPSIS
    use Net::RDAP::Registry;
    use Net::IP;
    use Net::ASN;

    $url = Net::RDAP::Registry->get_url(Net::DNS::Domain->new('example.com'));
    $url = Net::RDAP::Registry->get_url(Net::IP->new('192.168.0.1'));
    $url = Net::RDAP::Registry->get_url(Net::IP->new('2001:DB8::/32'));
    $url = Net::RDAP::Registry->get_url(Net::ASN->new(65536));
    $url = Net::RDAP::Registry->get_url('ABC123-TAG');

DESCRIPTION
RFC 7484 describes how RDAP clients can find the authoritative RDAP service for a given internet resource using one of several IANA registries.

This module provides an interface to these registries, and will return a URI object corresponding to the URL for a resource obtained from them.

Net::RDAP::Registry downloads the registry files from the IANA website and will maintain up-to-date copies of those files locally.

METHODS
    $url = Net::RDAP::Registry->get_url($resource);

This method returns a URI object corresponding to the authoritative RDAP URL for the given resource. $resource may be one of the following:

•   a Net::IP object representing an IPv4 or IPv6 address or address range;

•   a Net::ASN object representing an Autonymous System;

•   a Net::DNS::Domain object representing a domain name.

•   a string containing a tagged entity handle

This method requires objects to be passed to ensure that the resource identifiers have been properly validated.

If no URL can be found in the IANA registry, then "undef" is returned.

COPYRIGHT
Copyright 2018-2023 CentralNic Ltd, 2024-2025 Gavin Brown. For licensing information, please see the "LICENSE" file in the Net::RDAP distribution.