1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
|
openapi: "3.0.0"
info:
version: 1.0.0
title: API with Path Parameters
paths:
/users/{userId}/posts/{postId}:
get:
summary: Get a specific post by user
operationId: getUserPost
parameters:
- name: userId
in: path
required: true
schema:
type: integer
- name: postId
in: path
required: true
schema:
type: string
- name: includeComments
in: query
required: false
schema:
type: boolean
responses:
'200':
description: A post
content:
application/json:
schema:
$ref: "#/components/schemas/Post"
components:
schemas:
Post:
type: object
properties:
id:
type: string
title:
type: string
content:
type: string
|
