Skip to content

Commit ee4b871

Browse files
committed
docs: adds server url template anbf
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
1 parent d2c39a8 commit ee4b871

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

src/oas.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -557,6 +557,23 @@ servers:
557557
558558
An object representing a Server Variable for server URL template substitution.
559559
560+
The server URL templating is defined by the following [ABNF](https://tools.ietf.org/html/rfc5234) syntax.
561+
562+
```abnf
563+
server-url-template = 1*( server-literal / template-expression )
564+
server-literal = 1*pchar
565+
template-expression = "{" template-expression-param-name "}"
566+
template-expression-param-name = 1*( %x00-79 / %x7C / %x7E-10FFFF ) ; every UTF8 character except { and }
567+
568+
pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
569+
unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
570+
pct-encoded = "%" HEXDIG HEXDIG
571+
sub-delims = "!" / "$" / "&" / "'" / "(" / ")"
572+
/ "*" / "+" / "," / ";" / "="
573+
```
574+
575+
Here, `pchar`, `unreserved`, `pct-encoded` and `sub-delims` definitions are taken from [RFC 3986](https://tools.ietf.org/html/rfc3986).
576+
560577
##### Fixed Fields
561578

562579
| Field Name | Type | Description |

0 commit comments

Comments
 (0)