Net::RDAP::Service - an interface to an RDAP server.
# create a new service object:
my $svc = Net::RDAP::Service->new('https://www.example.com/rdap');
# get a domain:
my $domain = $svc->domain(Net::DNS::Domain->new('example.com'));
# do a search:
my $result = $svc->domains('name' => 'ex*mple.com');
# get help:
my $help = $svc->help;
While Net::RDAP provides a unified interface to the universe of RIR, domain registry, and domain registrar RDAP services, Net::RDAP::Service provides an interface to a specify RDAP service.
You can do direct lookup of objects using methods of the same name that Net::RDAP provides. In addition, this module allows you to perform searches.
my $svc = Net::RDAP::Service->new($url);
Creates a new Net::RDAP::Service object. $url is a string or a URI object representing the base URL of the service.
You can also provide a second argument which should be an existing Net::RDAP instance. This is used when fetching resources from the server.
You can do direct lookups of objects using the following methods:
They all work the same way as the methods of the same name on Net::RDAP.
You can perform searches using the following methods. Note that different services will support different search functions.
$result = $svc->domains(%QUERY);
$result = $svc->entities(%QUERY);
$result = $svc->nameservers(%QUERY);
In all cases, %QUERY is a set of search parameters. Here are some examples:
$result = $svc->domains('name' => 'ex*mple.com');
$result = $svc->entities('fn' => 'Ex*ample, Inc');
$result = $svc->nameservers('ip' => '192.168.0.1');
The following parameters can be specified:
domains: name (domain name), nsLdhName (nameserver name), nsIp (nameserver IP address)
nameservers: name (host name), ip (IP address)
entities: handle, fn (Formatted Name)
Search parameters can contain the wildcard character "*" anywhere in the string.
These methods all return Net::RDAP::SearchResult objects.
my $help = $svc->help;
The return value is a Net::RDAP::Help object.
Copyright 2022 CentralNic Ltd. All rights reserved.
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.
To install Net::RDAP, copy and paste the appropriate command in to your terminal.
perl -MCPAN -e shell
For more information on module installation, please visit the detailed CPAN module installation guide.