From 43bbbffc1cf623d548b06400fad82b5cc8476d35 Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Tue, 28 Apr 2020 10:51:50 +0100 Subject: [PATCH 1/2] oas 3.0 doesn't mention slashes not allowed --- versions/3.1.0.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index ac68e58d8d..77682808cc 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -75,6 +75,8 @@ Path templating refers to the usage of template expressions, delimited by curly Each template expression in the path MUST correspond to a path parameter that is included in the [Path Item](#path-item-object) itself and/or in each of the Path Item's [Operations](#operation-object). +The value for these path parameters MUST NOT contain unescaped forward slashes (`/`). + ##### Media Types Media type definitions are spread across several resources. The media type definitions SHOULD be in compliance with [RFC6838](https://tools.ietf.org/html/rfc6838). @@ -658,7 +660,7 @@ components: #### Paths Object Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [Access Control List (ACL) constraints](#securityFiltering). Paths MAY be omitted in some classes of OAS documents, including referenced sub-documents and overlays. +The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [Access Control List (ACL) constraints](#securityFiltering). Paths MAY be omitted in some classes of OAS documents, including referenced sub-documents and overlays. ##### Patterned Fields From 49bca4ec04ca6eeed6b7a51fb13b7c0529b3c5af Mon Sep 17 00:00:00 2001 From: Phil Sturgeon Date: Wed, 4 Nov 2020 14:21:17 +0000 Subject: [PATCH 2/2] none of those either --- versions/3.1.0.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/versions/3.1.0.md b/versions/3.1.0.md index 77682808cc..3b5d648947 100644 --- a/versions/3.1.0.md +++ b/versions/3.1.0.md @@ -75,7 +75,7 @@ Path templating refers to the usage of template expressions, delimited by curly Each template expression in the path MUST correspond to a path parameter that is included in the [Path Item](#path-item-object) itself and/or in each of the Path Item's [Operations](#operation-object). -The value for these path parameters MUST NOT contain unescaped forward slashes (`/`). +The value for these path parameters MUST NOT contain any unescaped "generic syntax" characters described by [RFC3986](https://tools.ietf.org/html/rfc3986#section-3): forward slashes (`/`), question marks (`?`), or hashes (`#`). ##### Media Types Media type definitions are spread across several resources. @@ -660,7 +660,7 @@ components: #### Paths Object Holds the relative paths to the individual endpoints and their operations. -The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [Access Control List (ACL) constraints](#securityFiltering). Paths MAY be omitted in some classes of OAS documents, including referenced sub-documents and overlays. +The path is appended to the URL from the [`Server Object`](#serverObject) in order to construct the full URL. The Paths MAY be empty, due to [Access Control List (ACL) constraints](#securityFiltering). Paths MAY be omitted in some classes of OAS documents, including referenced sub-documents and overlays. ##### Patterned Fields