-
Notifications
You must be signed in to change notification settings - Fork 0
/
person-api.yaml
95 lines (91 loc) · 2.2 KB
/
person-api.yaml
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
openapi: 3.0.3
info:
title: Person Service
description: Public service for querying the persons
version: 1.0
servers:
- description: Local development environment
url: http://localhost:8080/v1
- description: Kubernetes test environment
url: http://some-link-here.com/v1
- description: Kubernetes acc environment
url: http://some-link-here.com/v1
- description: Kubernetes production environment
url: http://some-link-here.com/v1
paths:
/person/{id}:
get:
operationId: getPerson
tags:
- person
parameters:
- name: id
in: path
description: person id
required: true
schema:
type: integer
format: int32
responses:
200:
description: Person results
content:
application/json:
schema:
$ref: '#/components/schemas/Person'
400:
description: not a valid person
/person:
get:
operationId: getPersons
tags:
- person
responses:
200:
description: Person results
content:
application/json:
schema:
$ref: '#/components/schemas/PersonList'
400:
description: not a valid person
post:
operationId: addPerson
tags:
- person
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/Person'
responses:
200:
description: Zoekresultaten
content:
application/json:
schema:
$ref: '#/components/schemas/Person'
400:
description: not a valid person
components:
schemas:
Person:
type: object
properties:
id:
required: true
description: id of the person
type: integer
format: int32
name:
description: name of the person
type: string
age:
description: age of the person
type: integer
format: int32
PersonList:
type: array
items:
$ref: '#/components/schemas/Person'