# Erläuterung zum URI-Template

Kurzbeschreibung zum URI-Template

URI-Templates werden nur für REQUEST-Contacts (General Request/Abuse Contact) verwendet. Ein URI-Template setzt sich aus einer URI und optionalen Variablen zusammen.

Bei einer Domainabfrage (Web-whois) werden in der URI (URL oder E-Mail-Adresse) die Variablen mit der abgefragten Domain ersetzt.

URI-Template-Beispiele

Beispiel mit einer URL:

Ein REQUEST-Contact enthält für ein URI-Template die folgende URL mit zwei Variablen:

    https://denic.de/contact/form?value1={Alabel}&value2={Ulabel}

Die Variablen werden in der URL mit geschweiften Klammern umschlossen und sind in dem Beispiel die von DENIC fest vorgegebenen Variablen Alabel und Ulabel.

Bei einer Domainabfrage (Web-whois) mit der Besipieldomain “beispiel-fünf.de“, wird die Domain den Variablen als ACE-String und UTF-8-String zugeordnet:

-     Alabel := „xn--beispiel-fnf-mlb.de“

-     Ulabel := „beispiel-fünf.de“

In der URL werden die Variablen mit den Strings ersetzt:

    https://denic.de/contact/form?value1=xn--beispiel-fnf-mlb.de&value2=beispiel-fünf.de

Beispiel mit einer E-Mail-Adresse:

Für einen REQUEST-Contact, mit einer E-Mail-Adresse und einer Variablen im URI-Template, wird bei einer Domainabfrage (Web-whois) mit der Beispieldomain “beispiel-fünf.de“ die Variable ersetzt.

Inhalt URI-Template:

    mailto:info@denic.de?subject=domain:{Ulabel}

Inhalt Variable:

Ulabel := „beispiel-fünf.de“

Ulabel ist eine von DENIC vorgegebene Variable für Domains in der Darstellung als UTF-8-String.

Die Variable wird mit dem String ersetzt:

    mailto:info@denic.de?subject=domain:beispiel-fünf.de

DENIC-Regeln für URI-Templates

- Das URI-Template darf maximal 1024 Zeichen lang sein.

- Es werden die URI Schemas http, https und mailto unterstützt.

- DENIC hat zwei Variablen für URI-Templates vordefiniert:

  - Alabel: Domain wird als ACE-String dargestellt.

  - Ulabel: Domain wird als UTF-8-String dargestellt.

- Die Variablen sind case-sensitive.

- Die Variablen sind optional.

- Die Verwendung anderer Variablen führt zu einem Fehler.

- Im URI-Template können beide Variablen mehrfach verwendet werden.

- Die Variablen werden mit der Domain nur bei einer Domainabfrage (Web-whois) ersetzt.

- Bei einer RRI-INFO-Abfrage wird das URI-Template mit den Variablen angezeigt.

HINWEIS | DENIC unterstützt nur den Level 1, wie in RFC 6570 - URI Template beschrieben.