Merge pull request #3747 from handrews/curly-braces-311

Correctly escape example operationRef URLs (3.1.1 port of #3731)
OAI · May 1, 2024 · 2ad9ff9 · 2ad9ff9
2 parents 88b199d + d2f194e
commit 2ad9ff9
Showing 1 changed file with 3 additions and 3 deletions.
diff --git a/versions/3.1.1.md b/versions/3.1.1.md
@@ -2180,7 +2180,7 @@ field in an [Operation Object](#operationObject)), references MAY also be made t
 links:
   UserRepositories:
     # returns array of '#/components/schemas/repository'
-    operationRef: '#/paths/~12.0~1repositories~1{username}/get'
+    operationRef: '#/paths/~12.0~1repositories~1%7Busername%7D/get'
     parameters:
       username: $response.body#/username
 ```
@@ -2191,13 +2191,13 @@ or an absolute `operationRef`:
 links:
   UserRepositories:
     # returns array of '#/components/schemas/repository'
-    operationRef: https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1{username}/get
+    operationRef: https://na2.gigantic-server.com/#/paths/~12.0~1repositories~1%7Busername%7D/get
     parameters:
       username: $response.body#/username
 ```
 
 Note that in the use of `operationRef`, the _escaped forward-slash_ is necessary when 
-using JSON references.
+using JSON Pointer, and it is necessary to URL-encode `{` and `}` as `%7B` and `%7D`, respectively when using JSON Pointer as URI fragments.
 
 
 ##### <a name="runtimeExpression"></a>Runtime Expressions