-
Notifications
You must be signed in to change notification settings - Fork 5
/
swagger.yml
executable file
·147 lines (141 loc) · 3.81 KB
/
swagger.yml
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
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
swagger: "2.0"
info:
description: This is the swagger yaml file
version: "1.0.0"
title: Swagger REST API
consumes:
- application/json
produces:
- application/json
basePath: /api
paths:
/people:
get:
operationId: people.get_all
tags:
- People
summary: Read the entire list of people
description: Read the list of people
parameters:
- name: length
in: query
type: integer
description: Number of people to get from people
required: false
- name: offset
in: query
type: integer
description: Offset from beginning of list where to start gathering people
required: false
responses:
200:
description: Successfully read people list operation
schema:
type: array
items:
properties:
fname:
type: string
lname:
type: string
age:
type: integer
favorite_color:
type: string
post:
operationId: people.add
tags:
- people
summary: Create a person and add it to the people list
description: Create a new person in the people list
parameters:
- name: person
in: body
description: Person to create
required: True
schema:
type: object
properties:
fname:
type: string
description: First name of person to create
lname:
type: string
description: Last name of person to create
age:
type: integer
description: Age of person to create
favorite_color:
type: string
description: Favourite color of person to create
responses:
201:
description: Successfully created person in list
/people/{fname}:
get:
operationId: people.get_one
tags:
- people
summary: Read one person from the people list
description: Read one person from the people list
parameters:
- name: fname
in: path
description: First name of the person to get from the list
type: string
required: True
responses:
200:
description: Successfully read person from people list operation
schema:
properties:
fname:
type: string
lname:
type: string
age:
type: integer
favorite_color:
type: string
put:
operationId: people.update
tags:
- people
summary: Update a person in the people list
description: Update a person in the people list
parameters:
- name: fname
in: path
description: First name of the person to update in the list
type: string
required: True
- name: person
in: body
schema:
type: object
properties:
fname:
type: string
lname:
type: string
age:
type: integer
favorite_color:
type: string
responses:
200:
description: Successfully updated person in people list
delete:
operationId: people.delete
tags:
- people
summary: Delete a person from the people list
description: Delete a person
parameters:
- name: fname
in: path
type: string
required: True
responses:
200:
description: Successfully deleted a person from people list