Skip to content

Commit 1e026ee

Browse files
committed
add additional param serialization examples
1 parent f797249 commit 1e026ee

1 file changed

Lines changed: 65 additions & 0 deletions

File tree

demo/examples/tests/paramSerialization.yaml

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,71 @@ paths:
122122
"200":
123123
description: Successful response
124124

125+
/api/resource:customVerb:
126+
post:
127+
tags:
128+
- params
129+
summary: Custom verb endpoint in path
130+
description: |
131+
Demonstrates a literal custom verb suffix in the path segment.
132+
Example:
133+
```
134+
Result: /api/resource:customVerb
135+
```
136+
responses:
137+
"200":
138+
description: Successful response
139+
140+
/files/{name}.{ext}:
141+
get:
142+
tags:
143+
- params
144+
summary: Path parameters in the same segment
145+
description: |
146+
Demonstrates multiple path parameters in a single path segment.
147+
Example:
148+
```
149+
{name} = "report"
150+
{ext} = "pdf"
151+
Result: /files/report.pdf
152+
```
153+
parameters:
154+
- name: name
155+
in: path
156+
required: true
157+
schema:
158+
type: string
159+
- name: ext
160+
in: path
161+
required: true
162+
schema:
163+
type: string
164+
responses:
165+
"200":
166+
description: Successful response
167+
168+
/jobs/{id}:cancel:
169+
post:
170+
tags:
171+
- params
172+
summary: Path template combined with custom verb
173+
description: |
174+
Demonstrates a path parameter with a verb-like suffix in the same segment.
175+
Example:
176+
```
177+
{id} = "123"
178+
Result: /jobs/123:cancel
179+
```
180+
parameters:
181+
- name: id
182+
in: path
183+
required: true
184+
schema:
185+
type: string
186+
responses:
187+
"200":
188+
description: Successful response
189+
125190
/search:
126191
get:
127192
tags:

0 commit comments

Comments
 (0)