Merge pull request #3748 from handrews/curly-braces-320

Correctly escape example operationRef URLs (3.2.0 port of #3731)
OAI · May 1, 2024 · 8fa2710 · 8fa2710
2 parents 6124cda + 6e9580b
commit 8fa2710
Showing 1 changed file with 3 additions and 3 deletions.
diff --git a/versions/3.2.0.md b/versions/3.2.0.md
@@ -2125,7 +2125,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
 ```
@@ -2136,13 +2136,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 Pointers, and it is necessary to URL-encode `{` and `}` as `%7B` and `%7D`, respectively when using JSON Pointers as URI fragments.
 
 
 ##### <a name="runtimeExpression"></a>Runtime Expressions