UriTemplate

URI Templates are similar to a macro language with a fixed set of macro definitions: the expression type determines the expansion process.

The default expression type is simple string expansion (Level 1), wherein a single named variable is replaced by its value as a string after pct-encoding any characters not in the set of unreserved URI characters (<a href="http://tools.ietf.org/html/rfc6570#section-1.5">Section 1.5</a>).

Level 2 templates add the plus ("+") operator, for expansion of values that are allowed to include reserved URI characters (<a href="http://tools.ietf.org/html/rfc6570#section-1.5">Section 1.5</a>), and the crosshatch ("#") operator for expansion of fragment identifiers.

Level 3 templates allow multiple variables per expression, each separated by a comma, and add more complex operators for dot-prefixed labels, slash-prefixed path segments, semicolon-prefixed path parameters, and the form-style construction of a query syntax consisting of name=value pairs that are separated by an ampersand character.

Static fragment element

Fragment expansion with multiple variables, crosshatch-prefixed (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.4">Section 3.2.4</a>)

Form-style query continuation (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.9">Section 3.2.9</a>)

Static query parameter element

Form-style query, ampersand-separated (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.8">Section 3.2.8</a>)

Reserved string expansion for query parameter

Simple string expansion for query parameter

Static path element

Path segments, slash-prefixed (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.6">Section 3.2.6</a>)

Level 2 allows reserved string expansion (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.3">Section 3.2.3</a>)

Level 3 allows reserved expansion with multiple variables (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.3">Section 3.2.3</a>)

Fragment expansion, crosshatch-prefixed (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.4">Section 3.2.4</a>)

Level 1 allows string expansion (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.2">Section 3.2.2</a>)

Level 3 allows string expansion with multiple variables (<a href="http://tools.ietf.org/html/rfc6570#section-3.2.2">Section 3.2.2</a>)

The names of the product elements

The name of the type