Informacje ogólne o RDAP w NASK
NASK, jako główny rejestr domeny krajowej .pl, udostępnia dane dotyczące zarejestrowanych domen internetowych. Dane te można uzyskać m.in. poprzez wykorzystanie protokołu RDAP (Registration Data Access Protocol).
Protokół RDAP
Protokół RDAP (Registration Data Access Protocol) został opracowany przez społeczność IETF (Internet Engineering Task Force) w celu umożliwienia użytkownikom dostępu do aktualnych danych rejestracyjnych.
RDAP opiera się na REST API. RDAP dostarcza dane w standardowym, nadającym się do odczytu maszynowego, formacie JSON. W związku z tym, że taki sposób prezentowania danych nie jest przyjazny użytkownikowi, organizacja ICANN stworzyła usługę, dzięki której każdy użytkownik Internetu może w przejrzysty sposób pozyskać dane rejestracyjne wybranego obiektu - RDAP WEB Client.
Więcej informacji dotyczących RDAP znajdziesz w poszczególnych RFC:
- RFC 7480, HTTP Usage in the Registration Data Access Protocol (RDAP)
- RFC 7481, Security Services for the Registration Data Access Protocol (RDAP)
- RFC 8056, Extensible Provisioning Protocol (EPP) and Registration Data Access Protocol (RDAP) Status Mapping
- RFC 9082, Registration Data Access Protocol (RDAP) Query Format
- RFC 9083, JSON Responses for the Registration Data Access Protocol (RDAP)
- RFC 9224, Finding the Authoritative Registration Data Access Protocol (RDAP) Service
Rozszerzenia protokołu RDAP
Protokół RDAP pozwala na zaimplementowanie własnych rozszerzeń. Każdy rejestr korzystający z własnych rozszerzeń musi je opisać, a następnie zostają one umieszczone za pośrednictwem IANA na liście rozszerzeń, aby każdy użytkownik mógł się z nimi zapoznać.
Implemetacja protokołu RDAP w NASK dotyczy odpytań o obiekt "domena" i wprowadza rozszerzenia własne NASK, opisane w dokumencie opublikowanym w naszej witrynie pod adresem: https://www.dns.pl//NASK_extension_of_RDAP_Response.
Korzystanie z protokołu RDAP w Rejestrze .pl
Każdy użytkownik, posługując się odpowiednim zapytaniem, może uzyskać informacje dot. wybranej domeny należącej do strefy zarządzanej przez NASK.
Ścieżka zapytania
https://rdap.dns.pl/domain/{nazwa domeny}
Kody odpowiedzi HTTP
W RDAP każda odpowiedź na żądanie kierowane do serwera zawiera odpowiednie dane w formacie JSON (jeśli dotyczy) wraz z jednym z czterech statusów HTTP:
- 200 – prawidłowe zapytanie o istniejący obiekt w rejestrze,
- 400 – nieprawidłowe zapytanie,
- 404 – prawidłowe zapytanie dotyczące nieistniejącego obiektu w rejestrze,
- 500 – błąd serwera.
Odpowiedź
Odpowiedź na zapytanie o istniejącą nazwę domeny .pl może zawierać następujące elementy:
- rdapConformance – tablica ciągów znaków, z których każdy zawiera wskazówkę dotyczącą używanej specyfikacji,
- notices – dodatkowe informacje na temat usługi,
- entities – zawiera informacje dotyczących podmiotów powiązanych z domeną takich jak Registrar lub Registrant,
- events – zawiera informacje dotyczące zdarzeń, które miały miejsce w domenie,
- ldhName – tekstowe reprezentacje nazw DNS, w których wszystkie etykiety domeny są etykietami typu "letters, digits, hyphen", zgodnie z opisem RFC5890,
- port43 – nazwa hosta serwera WHOIS rejestru,
- secureDNS – informacje dotyczące rekordów DNSSEC,
- nameservers – tablica obiektów serwerów nazw,
- remarks - dodatkowe informacje na temat klasy obiektu,
- links – odnośniki do źródeł pochodzenia informacji,
- objectClassName – ciąg znaków „domain” reprezentujący typ obiektu w RDAP,
- nask0_state - ciąg znaków w obiekcie "domena", mówiący o aktualnym stanie domeny,
- nask0_option – obiekt systemu rejestru, reprezentujący prawo pierwszeństwa rejestracji nazwy domeny utrzymywanej w NASK, w przypadku jej udostępnienia do rejestracji,
- handle – unikalny identyfikator obiektu.
{
"rdapConformance": [
"rdap_level_0",
"nask0"
],
"notices": [
{
"title": "Domain name life cycle",
"links": [
{
"value": "https://www.dns.pl/en/domain_name_life_cycle",
"rel": "related",
"href": "https://www.dns.pl/en/domain_name_life_cycle",
"type": "text/html"
}
]
}
],
"entities": [
{
"vcardArray": [
"vcard",
[
[
"version",
{
},
"text",
"4.0"
],
[
"fn",
{
},
"text",
""
],
[
"kind",
{
},
"text",
"individual"
]
]
],
"roles": [
"registrant"
],
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"objectClassName": "entity"
},
{
"vcardArray": [
"vcard",
[
[
"version",
{
},
"text",
"4.0"
],
[
"fn",
{
},
"text",
"NASK"
],
[
"kind",
{
},
"text",
"org"
],
[
"adr",
{
"cc": "PL"
},
"text",
[
"",
"",
"ul. Kolska 12",
"Warszawa",
"",
"01-045",
""
]
],
[
"tel",
{
"type": "VOICE"
},
"uri",
"tel:+48.223808300"
],
[
"email",
{
},
"text",
"info@dns.pl"
]
]
],
"roles": [
"registrar"
],
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"objectClassName": "entity"
}
],
"events": [
{
"eventDate": "1998-09-10T19:21:25Z",
"eventAction": "registration"
},
{
"eventDate": "2013-10-23T10:37:26Z",
"eventAction": "last changed"
},
{
"eventDate": "2025-01-16T13:20:14.741657257Z",
"eventAction": "last update of RDAP database"
}
],
"links": [
{
"value": "https://rdap.dns.pl/domain/nask.pl",
"rel": "self",
"href": "https://rdap.dns.pl/domain/nask.pl",
"type": "application/rdap+json"
}
],
"ldhName": "nask.pl",
"port43": "whois.pl",
"secureDNS": {
"delegationSigned": false
},
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"nameservers": [
{
"ldhName": "eomer.nask.pl",
"ipAddresses": [
{
"v4": [
"193.59.201.24"
]
}
],
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"objectClassName": "nameserver"
},
{
"ldhName": "kirdan.nask.pl",
"ipAddresses": [
{
"v4": [
"195.187.244.8"
]
}
],
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"objectClassName": "nameserver"
}
],
"objectClassName": "domain",
"nask0_state": "registered",
"nask0_option": {
"ldhName": "nask.pl",
"events": [
{
"eventDate": "2023-06-12T08:09:06Z",
"eventAction": "registration"
},
{
"eventDate": "2026-06-12T08:09:06Z",
"eventAction": "expiration"
}
],
"remarks": [
{
"title": "REDACTED FOR PRIVACY",
"type": "object truncated due to authorization",
"description": [
"The object does not contain all data
due to lack of authorization."
]
}
],
"objectClassName": "nask0_option"
}
}