Skoči na vsebino
Register.si - Home
  • en

RDAP


Protokol RDAP (Registration Data Access Protocol) je naslednik WHOIS. Tako kot WHOIS tudi RDAP omogoča dostop do podatkov o internetnih virih (domene, imenski strežniki, kontakti, številke avtonomnih sistemov in naslovi IP). Za razliko od WHOIS RDAP zagotavlja:

  • strojno berljivost (json);
  • diferenciran dostop;
  • strukturirano semantiko zahtev in odgovorov;
  • internacionalizacijo;
  • razširljivost.

Register.si upravlja strežnik RDAP za iskanje podatkov o registraciji .si domen. Podpira objekte tipa “domena”, “imenski strežnik” in “entitete”. Odgovor je na voljo v obliki JSON. Do strežnika RDAP lahko dostopate prek katerega koli odjemalca HTTP.

Anonimnim uporabnikom niso prikazane informacije o nosilcih domen ali tehničnem kontaktu. Avtenticirani uporabniki z uporabniškim računom prejmejo vse podatke o registraciji, odvisno od njihovih pooblastil, in imajo tudi možnost iskanja po RDAP.

Kako deluje?

  • z REST odjemalcem (samostojno ali kot razširitev brskalnika),
  • z uporabo terminala (ukazna vrstica),
  • z uporabo brskalnika.

Oglejte si spodnje primere.

Poleg zahtevkov GET lahko uporabite tudi zahteve HEAD. Na zahtevo HEAD bo RDAP odgovoril le, ali je domena že registrirana, brez posredovanja ostalih podatkov.

O poizvedbah

V RDAP lahko poizvedujete po:

  • domenah – RDAP vrne podatke o domenah, kot so imenski strežniki, status, itd. Rezultat se razlikuje glede na to, ali je uporabnik prijavljen ali ne.

    Oblika URL za domene je https://rdap.register.si/domain/queriedDomain

  • imenskih strežnikih – RDAP vrne podatke o imenskih strežnikih, kot so stanje, naslovi IP, itd.

    Oblika URL za imenske strežnike je https://rdap.register.si/nameserver/queriedNamerserver

  • entitetah – entitete so kontakti na domeni in registrarji. Rezultat RDAP se razlikuje glede na to, ali je uporabnik prijavljen ali ne.

    Oblika URL za kontakte je https://rdap.register.si/entity/c-queriedContact

    Oblika URL za registrarje je https://rdap.register.si/entity/r-queriedRegistrar

Anonimni primeri
  • z REST odjemalcem

    Method: GET (ali HEAD)
    URL: https://rdap.register.si/domain/arnes.si

    URL: https://rdap.register.si/nameserver/ns1.arnes.si

    URL: https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

  • z ukazno vrstico

    curl https://rdap.register.si/domain/arnes.si

    curl https://rdap.register.si/nameserver/ns1.arnes.si

    curl https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

    HEAD request:

    curl -I https://rdap.register.si/domain/arnes.si

    curl -I https://rdap.register.si/nameserver/ns1.arnes.si

    curl -I https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

  • z brskalnikom
    V vnosno polje brskalnika vpišite:

    https://rdap.register.si/domain/arnes.si

    https://rdap.register.si/nameserver/ns1.arnes.si

    https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

Primeri, ko je uporabnik prijavljen
  • z REST odjemalcem

    Method: GET (ali HEAD)
    URL: https://rdap.register.si/domain/arnes.si

    URL: https://rdap.register.si/nameserver/ns1.arnes.si

    URL: https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

    Uporabite “Basic Authentication” in vnesite vaše uporabniško ime ter geslo.

  • z ukazno vrstico

    curl -u username https://rdap.register.si/domain/arnes.si

    curl -u username https://rdap.register.si/nameserver/ns1.arnes.si

    curl -u username https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

    HEAD request:

    curl -I https://rdap.register.si/domain/arnes.si

    curl -I https://rdap.register.si/nameserver/ns1.arnes.si

    curl -I https://rdap.register.si/entity/r-0d8eaedc-82a8-11ee-97b4-7cd30ae19050

  • iskanje za prijavljene uporabnike
    Iskanje podpira wildcard, možno je vnesti maksimalno eno zvezdico (*).
    Rezultat za neustrezna iskanja je error koda 422 (Unprocessable Entity).

    • Domene
      iskanje po imenu domene
      domains?name=domena ali vzorec iskanja
      https://rdap.register.si/domains?name=arnes*.si

      iskanje domen po imenskem strežniku
      domains?nsLdhName=strežnik ali vzorec iskanja
      https://rdap.register.si/domains?nsLdhName=ns1.arnes*.si

      iskanje domen po naslovu IP imenskega strežnika
      domains?nsIp=naslov IP
      https://rdap.register.si/domains?nsIp=192.0.2.0

    • Imenski strežniki
      iskanje po imenu imenskega strežnika
      nameservers?name=strežnik ali vzorec iskanja
      https://rdap.register.si/nameservers?name=ns1.arnes*.si

      iskanje po naslovu IP
      nameservers?ip=naslov IP
      https://rdap.register.si/nameservers?ip=192.0.2.0

    • Entitete
      iskanje po nazivu
      entities?fn=naziv ali vzorec iskanja
      https://rdap.register.si/entities?fn=Bobby%20Joe*

      iskanje po ID številki
      entities?handle=ID entitete ali vzorec iskanja
      https://rdap.register.si/entities?handle=CID-40*

Kakšni so odgovori?

Če je domena registrirana, se strežnik RDAP odzove s podatki v obliki JSON in kodo HTTP 200 (ali 401). Če domene ali vnosa ni mogoče najti, se strežnik odzove samo s kodami HTTP. Pri iskanju v brskalniku te kode niso neposredno vidne. Rezultat je lahko sporočilo o napaki ali prazna stran. Pri zahtevi HEAD se strežnik vedno odzove samo s kodami HTTP, brez ostalih podatkov.

Pomen HTTP kod:

404 (Not Found): Domena ni bila najdena. Običajno to pomeni, da domena ni registrirana. Vendar to pa ne pomeni vedno, da jo je mogoče registrirati.

200 (OK): Domena je registrirana.

400 (Bad Request): Nepravilna zahteva lahko na primer vsebuje prepovedane znake ali napačno končnico domene (pred naslednjim poskusom spremenite poizvedbo).

401 (Unauthorized): Uporabniško ime/geslo je napačno. Domena je registrirana, vendar prejmete enake podatke kot anonimni uporabnik.

429 (Too Many Requests): Dostop je omejen (počakajte nekaj časa in poskusite znova).

Viri

Viri za RDAP protokol: