# Explanation of the URI-Template

Short description of the URI-Template

URI-Templates are only used for REQUEST contacts (General Request / Abuse Contact). A URI-Template consists of a URI and optional variables.

In the case of a domain query (web-whois), the variables with the queried domain are replaced in the URI (URL or e-mail address).

URI-Template examples

Example with a URL:

A REQUEST contact contains the following URL with two variables for a URI-Template:

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

The variables in the URL are enclosed in curly brackets and are DENIC's predefined variables for Alabel and Ulabel.

For a domain query (web-whois) with the example domain "beispiel-fünf.de", the domain is assigned to the variables as an ACE string and UTF-8 string:

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

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

In the URL, the variables are replaced with the strings:

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

Example with an e-mail address:

For a REQUEST contact, with an e-mail address and a variable in the URI-Template, the variable is replaced in the case of a domain query (web-whois) with the example domain "beispiel-fünf.de".

Content URI-Template:

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

Content variable:

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

Ulabel is DENIC‘s predefined variable for domains represented as UTF-8 strings.

The variable is replaced with the string:

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

DENIC‘s rules for URI-Templates

- The URI-Template can be up to 1024 characters long.
- The URI schemas http, https and mailto are supported.
- DENIC has predefined two variables for URI templates:
  - Alabel: Domain is displayed as an ACE string.
  - Ulabel: Domain is represented as UTF-8 string.

- The variables are case-sensitive.
- The variables are optional.
- The use of other variables leads to an error.
- Both variables can be used multiple times in the URI-Template.
- The variables are replaced with the domain only for a domain query (web-whois).
- For an RRI INFO query, the URI-Template is displayed with the variables.

Notice |  | DENIC only supports level 1 as described in the RFC 6570 - URI Template.