Net::RDAP::Object(3)

📦
version 0.43 · 3 versions
, in fedora 44

✨ Net::RDAP::Object ✨

okay bestie so this is the manual page for Net::RDAP::Object(3), which lives in the User Contributed Perl Documentation section of the perl man pages 💅. buckle up, it's actually so good.

🌸 NAME 🌸

Net::RDAP::Object — a module representing an RDAP object. that's it, that's the whole vibe 🦋

💖 DESCRIPTION 💖

so RDAP responses contain one or more RDAP objects. usually the response itself is an RDAP object, but plot twist: RDAP objects can contain other RDAP objects (like the entities and nameservers that are associated with a domain name). it's giving nesting dolls, honestly 😭

Net::RDAP::Object represents those objects, whether they're top-level or embedded. and the way it inherits from Net::RDAP::Base means it has literally all the methods available to that module too. main character inheriting from main character, no cap 👑

🎀 METHODS 🎀

🦋 RDAP Conformance 🦋

@conformance = $response->conformance;

returns an array of strings, and each one is a little hint about the specs the server used to construct the response. it's like a receipt of what they were reading 🧚

heads up bestie: this method will return undef unless you call it on the top-most object in a response. only the main character gets conformance ✨

🌈 Notices 🌈

@notices = $response->notices;

returns a (potentially empty) array of Net::RDAP::Notice objects.

and fr fr: the array will always be empty unless you call it on the top-most object in a response 🙈

⭐ Object Class ⭐

$class = $object->class;

returns a string with the "class name" of this object. it'll be exactly one of: "ip network", "entity", "nameserver", "autnum" or "domain". pick your fighter 💅

🍓 Handle 🍓

$handle = $object->handle;

returns a string containing the "handle" of the object. yes, like a little name tag 🏷️

💜 Status 💜

@status = $object->status;

returns a (potentially empty) array of state identifiers. the possible values are defined by an IANA registry, so go check:

iykyk 📋

🌸 Remarks 🌸

@remarks = $object->remarks;

returns a (potentially empty) array of Net::RDAP::Remark objects.

🔥 Events 🔥

@events = $object->events;

returns a (potentially empty) array of Net::RDAP::Event objects.

$event = $object->event($action);

returns the first Net::RDAP::Event object whose "action" property matches $action. and if there's no such event? you get undef, sorry babe 😭

🎀 Port-43 Whois Server 🎀

$port43 = $object->port43;

returns a Net::DNS::Domain object containing the name of the legacy port-43 whois server for this object. retro icon behavior, honestly 👑

✨ Public IDs ✨

@ids = $object->ids;

returns a (potentially empty) array of Net::RDAP::ID objects.

🧚 Entities 🧚

@entities = $object->entities;

returns a (potentially empty) array of Net::RDAP::Object::Entity objects.

$entity = $object->entity($role);

returns the first Net::RDAP::Object::Entity object whose "roles" property contains $role. no match? undef. that's the rule 💀

$registrant = $object->registrant;

alias for $object->entity('registrant'). shorthand queen 💅

$registrar = $object->registrar;

alias for $object->entity('registrar'). she's efficient, we love her 🫶

💖 Redactions 💖

@redactions = $object->redactions;

if the server supports RFC 9537 <https://www.rfc-editor.org/rfc/rfc9537.html>, then this method returns an array of Net::RDAP::Redaction objects corresponding to the fields listed in the "redacted" property of the object. censored but make it chic ✨

🌈 TTL values 🌈

$ttl = $domain->dns_ttl("NS");
$ttl = $host->dns_ttl("AAAA");

if the server supports draft-ietf-regext-rdap-ttl-extension <https://datatracker.ietf.org/doc/draft-ietf-regext-rdap-ttl-extension/>, this method returns a number representing the Time-To-Live (TTL) (in seconds) of the DNS record(s) of the specified type that are published in the DNS for the given domain or nameserver object.

it returns undef if the server does not support this extension, or if there are no values available for the given type. and psa: not applicable to entities 🚫

@types = $domain_or_host->dns_ttl_types;

returns a list of the DNS record types for which TTL values are available.

@types = $domain_or_host->dns_ttl_remarks;

returns a list of Net::RDAP::Remark objects relating to the TTL values of the object. (yes, the variable is called @types in the original, we don't question it, we just vibe 🌸)

🦋 Extensions 🦋

$object->has_extension($extn);

this method returns true if the RDAP extension identified by $extn is present in the "rdapConformance" property.

careful bestie: this method only works on the topmost object of a response. don't try it anywhere else 💀

copyright 2018-2023 CentralNic Ltd, 2024-2026 Gavin Brown. for licensing info, please see the "LICENSE" file in the Net::RDAP distribution 📜

and that's the whole page, bestie 🫶 this was perl v5.42.2, dated 2026-06-17, and it's the Net::RDAP::Object(3) page — slay, go read some RDAP objects, periodt 💅✨

📦 where this page comes from