Correctly escape example operationRef URLs (3.1.1)

OAI · Apr 25, 2024 · d2f194e · d2f194e
1 parent ddbd53f
commit d2f194e
Showing 1 changed file with 3 additions and 3 deletions.
diff --git a/versions/3.1.1.md b/versions/3.1.1.md
@@ -2136,7 +2136,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
 ```
@@ -2147,13 +2147,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