|
1
|
<!DOCTYPE HTML><html><head><title>YManager API documentation</title><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="generator" content="https://github.com/raml2html/raml2html 7.5.0"><link rel="stylesheet" href="https://netdna.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css"><link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/styles/default.min.css"><script type="text/javascript" src="https://code.jquery.com/jquery-1.11.0.min.js"></script><script type="text/javascript" src="https://netdna.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js"></script><script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.12.0/highlight.min.js"></script><script type="text/javascript">
|
|
2
|
$(document).ready(function() {
|
|
3
|
$('.page-header pre code, .top-resource-description pre code, .modal-body pre code').each(function(i, block) {
|
|
4
|
hljs.highlightBlock(block);
|
|
5
|
});
|
|
6
|
|
|
7
|
$('[data-toggle]').click(function() {
|
|
8
|
var selector = $(this).data('target') + ' pre code';
|
|
9
|
$(selector).each(function(i, block) {
|
|
10
|
hljs.highlightBlock(block);
|
|
11
|
});
|
|
12
|
});
|
|
13
|
|
|
14
|
// open modal on hashes like #_action_get
|
|
15
|
$(window).bind('hashchange', function(e) {
|
|
16
|
var anchor_id = document.location.hash.substr(1); //strip #
|
|
17
|
var element = $('#' + anchor_id);
|
|
18
|
|
|
19
|
// do we have such element + is it a modal? --> show it
|
|
20
|
if (element.length && element.hasClass('modal')) {
|
|
21
|
element.modal('show');
|
|
22
|
}
|
|
23
|
});
|
|
24
|
|
|
25
|
// execute hashchange on first page load
|
|
26
|
$(window).trigger('hashchange');
|
|
27
|
|
|
28
|
// remove url fragment on modal hide
|
|
29
|
$('.modal').on('hidden.bs.modal', function() {
|
|
30
|
try {
|
|
31
|
if (history && history.replaceState) {
|
|
32
|
history.replaceState({}, '', '#');
|
|
33
|
}
|
|
34
|
} catch(e) {}
|
|
35
|
});
|
|
36
|
});
|
|
37
|
</script><style>
|
|
38
|
.hljs {
|
|
39
|
background: transparent;
|
|
40
|
}
|
|
41
|
.parent {
|
|
42
|
color: #999;
|
|
43
|
}
|
|
44
|
.list-group-item > .badge {
|
|
45
|
float: none;
|
|
46
|
margin-right: 6px;
|
|
47
|
}
|
|
48
|
.panel-title > .methods {
|
|
49
|
float: right;
|
|
50
|
}
|
|
51
|
.badge {
|
|
52
|
border-radius: 0;
|
|
53
|
text-transform: uppercase;
|
|
54
|
width: 70px;
|
|
55
|
font-weight: normal;
|
|
56
|
color: #f3f3f6;
|
|
57
|
line-height: normal;
|
|
58
|
}
|
|
59
|
.badge_get {
|
|
60
|
background-color: #63a8e2;
|
|
61
|
}
|
|
62
|
.badge_post {
|
|
63
|
background-color: #6cbd7d;
|
|
64
|
}
|
|
65
|
.badge_put {
|
|
66
|
background-color: #22bac4;
|
|
67
|
}
|
|
68
|
.badge_delete {
|
|
69
|
background-color: #d26460;
|
|
70
|
}
|
|
71
|
.badge_patch {
|
|
72
|
background-color: #ccc444;
|
|
73
|
}
|
|
74
|
.list-group,
|
|
75
|
.panel-group {
|
|
76
|
margin-bottom: 0;
|
|
77
|
}
|
|
78
|
.panel-group .panel+.panel-white {
|
|
79
|
margin-top: 0;
|
|
80
|
}
|
|
81
|
.panel-group .panel-white {
|
|
82
|
border-bottom: 1px solid #F5F5F5;
|
|
83
|
border-radius: 0;
|
|
84
|
}
|
|
85
|
.panel-white:last-child {
|
|
86
|
border-bottom-color: white;
|
|
87
|
-webkit-box-shadow: none;
|
|
88
|
box-shadow: none;
|
|
89
|
}
|
|
90
|
.panel-white .panel-heading {
|
|
91
|
background: white;
|
|
92
|
}
|
|
93
|
.tab-pane ul {
|
|
94
|
padding-left: 2em;
|
|
95
|
}
|
|
96
|
.tab-pane h1 {
|
|
97
|
font-size: 1.3em;
|
|
98
|
}
|
|
99
|
.tab-pane h2 {
|
|
100
|
font-size: 1.2em;
|
|
101
|
padding-bottom: 4px;
|
|
102
|
border-bottom: 1px solid #ddd;
|
|
103
|
}
|
|
104
|
.tab-pane h3 {
|
|
105
|
font-size: 1.1em;
|
|
106
|
}
|
|
107
|
.tab-content {
|
|
108
|
border-left: 1px solid #ddd;
|
|
109
|
border-right: 1px solid #ddd;
|
|
110
|
border-bottom: 1px solid #ddd;
|
|
111
|
padding: 10px;
|
|
112
|
}
|
|
113
|
#sidebar {
|
|
114
|
margin-top: 30px;
|
|
115
|
padding-right: 5px;
|
|
116
|
overflow: auto;
|
|
117
|
height: 90%;
|
|
118
|
}
|
|
119
|
.top-resource-description {
|
|
120
|
border-bottom: 1px solid #ddd;
|
|
121
|
background: #fcfcfc;
|
|
122
|
padding: 15px 15px 0 15px;
|
|
123
|
margin: -15px -15px 10px -15px;
|
|
124
|
}
|
|
125
|
.resource-description {
|
|
126
|
border-bottom: 1px solid #fcfcfc;
|
|
127
|
background: #fcfcfc;
|
|
128
|
padding: 15px 15px 0 15px;
|
|
129
|
margin: -15px -15px 10px -15px;
|
|
130
|
}
|
|
131
|
.resource-description p:last-child {
|
|
132
|
margin: 0;
|
|
133
|
}
|
|
134
|
.list-group .badge {
|
|
135
|
float: left;
|
|
136
|
}
|
|
137
|
.method_description {
|
|
138
|
margin-left: 85px;
|
|
139
|
}
|
|
140
|
.method_description p:last-child {
|
|
141
|
margin: 0;
|
|
142
|
}
|
|
143
|
.list-group-item {
|
|
144
|
cursor: pointer;
|
|
145
|
}
|
|
146
|
.list-group-item:hover {
|
|
147
|
background-color: #f5f5f5;
|
|
148
|
}
|
|
149
|
pre code {
|
|
150
|
overflow: auto;
|
|
151
|
word-wrap: normal;
|
|
152
|
white-space: pre;
|
|
153
|
}
|
|
154
|
.items {
|
|
155
|
background: #f5f5f5;
|
|
156
|
color: #333;
|
|
157
|
border: 1px solid #ccc;
|
|
158
|
border-radius: 4px;
|
|
159
|
padding: 9.5px;
|
|
160
|
margin: 0 0 10px;
|
|
161
|
font-size: 13px;
|
|
162
|
line-height: 1.42857143;
|
|
163
|
}
|
|
164
|
.examples {
|
|
165
|
margin-left: 0.5em;
|
|
166
|
}
|
|
167
|
.resource-modal li > ul {
|
|
168
|
margin-bottom: 1em;
|
|
169
|
}
|
|
170
|
.required {
|
|
171
|
color: #f00;
|
|
172
|
}
|
|
173
|
</style></head><body data-spy="scroll" data-target="#sidebar"><div class="container"><div class="row"><div class="col-md-9" role="main"><div class="page-header"><h1>YManager API documentation</h1><p></p></div><div class="panel panel-default"><div class="panel-heading"><h3 id="users" class="panel-title">/users</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_users"><span class="parent"></span>/users</a> <span class="methods"><a href="#users_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_users" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#users_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="users_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent"></span>/users</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#users_get_request" data-toggle="tab">Request</a></li><li><a href="#users_get_response" data-toggle="tab">Response</a></li><li><a href="#users_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="users_get_request"><h3>Query Parameters</h3><ul><li><strong>status</strong>: <em>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><div class="tab-pane" id="users_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li><li><strong>firstName</strong>: <em><span class="required">required</span>(string)</em><p>the user's first name</p></li><li><strong>lastName</strong>: <em><span class="required">required</span>(string)</em><p>the user's last name</p></li><li><strong>photo</strong>: <em><span class="required">required</span>(string)</em><p>the URL of a photo</p></li><li><strong>calendar</strong>: <em><span class="required">required</span>(array of VacationDayDTO)</em><p>the list of selected vacation in +-7 days</p><p><strong>Items</strong>: VacationDayDTO</p><div class="items"><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the id of the vacation/sick day</p></li><li><strong>date</strong>: <em><span class="required">required</span>(string)</em><p>the date of the vacation/sick day in yyyy/mm/dd format</p></li><li><strong>from</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the start of the vacation, null for sick days</p></li><li><strong>to</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the end of the vacation, null for sick days</p></li><li><strong>type</strong>: <em><span class="required">required</span>(one of VACATION, SICK_DAY)</em></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div></li></ul><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check query parameters.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="users_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_users_requests_vacation"><span class="parent">/users/requests</span>/vacation</a> <span class="methods"><a href="#users_requests_vacation_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_users_requests_vacation" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#users_requests_vacation_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="users_requests_vacation_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/users/requests</span>/vacation</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#users_requests_vacation_get_request" data-toggle="tab">Request</a></li><li><a href="#users_requests_vacation_get_response" data-toggle="tab">Response</a></li><li><a href="#users_requests_vacation_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="users_requests_vacation_get_request"><h3>Query Parameters</h3><ul><li><strong>status</strong>: <em>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><div class="tab-pane" id="users_requests_vacation_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: array of object</p><p><strong>Items</strong>: UserVacationRequestDTO</p><div class="items"><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li><li><strong>firstName</strong>: <em><span class="required">required</span>(string)</em><p>the user's first name</p></li><li><strong>lastName</strong>: <em><span class="required">required</span>(string)</em><p>the user's last name</p></li><li><strong>date</strong>: <em><span class="required">required</span>(string)</em><p>the date of the vacation/sick day in yyyy/mm/dd format</p></li><li><strong>from</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the start of the vacation, null for sick days</p></li><li><strong>to</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the end of the vacation, null for sick days</p></li><li><strong>type</strong>: <em><span class="required">required</span>(one of VACATION, SICK_DAY)</em><p>the approval status of the request</p></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em></li><li><strong>timestamp</strong>: <em><span class="required">required</span>(string)</em><p>the creation of the request in yyyy/mm/dd hh:mm:ss format</p></li></ul></div><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check query parameters.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="users_requests_vacation_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_users_requests_authorization"><span class="parent">/users/requests</span>/authorization</a> <span class="methods"><a href="#users_requests_authorization_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_users_requests_authorization" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#users_requests_authorization_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="users_requests_authorization_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/users/requests</span>/authorization</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#users_requests_authorization_get_request" data-toggle="tab">Request</a></li><li><a href="#users_requests_authorization_get_response" data-toggle="tab">Response</a></li><li><a href="#users_requests_authorization_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="users_requests_authorization_get_request"><h3>Query Parameters</h3><ul><li><strong>status</strong>: <em>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><div class="tab-pane" id="users_requests_authorization_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: array of object</p><p><strong>Items</strong>: UserAuthorizationRequestDTO</p><div class="items"><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li><li><strong>firstName</strong>: <em><span class="required">required</span>(string)</em><p>the user's first name</p></li><li><strong>lastName</strong>: <em><span class="required">required</span>(string)</em><p>the user's last name</p></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em><p>the status of the authorisation</p></li><li><strong>timestamp</strong>: <em><span class="required">required</span>(string)</em><p>the creation of the request in yyyy/mm/dd hh:mm:ss format</p></li></ul></div><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check query parameters.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="users_requests_authorization_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_users_current_profile"><span class="parent">/users/current</span>/profile</a> <span class="methods"><a href="#users_current_profile_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_users_current_profile" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#users_current_profile_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="users_current_profile_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/users/current</span>/profile</h4></div><div class="modal-body"><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#users_current_profile_get_response" data-toggle="tab">Response</a></li><li><a href="#users_current_profile_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="users_current_profile_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li><li><strong>firstName</strong>: <em><span class="required">required</span>(string)</em><p>the user's first name</p></li><li><strong>lastName</strong>: <em><span class="required">required</span>(string)</em><p>the user's last name</p></li><li><strong>photo</strong>: <em><span class="required">required</span>(string)</em><p>the URL of a photo</p></li><li><strong>vacationCount</strong>: <em><span class="required">required</span>(number)</em><p>the number of available vacations</p></li><li><strong>sickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of assigned sick days</p></li><li><strong>takenSickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of taken sick days</p></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em><p>the authorisation status</p></li><li><strong>role</strong>: <em><span class="required">required</span>(one of EMPLOYEE, EMPLOYER)</em><p>the user role</p></li><li><strong>notification</strong>: <em><span class="required">required</span>(string)</em><p>the notification of an incoming reset of remaining vacations and sick days in yyyy/mm/dd hh:mm:ss format</p></li><li><strong>email</strong>: <em><span class="required">required</span>(string)</em><p>the user's email address</p></li></ul><p><strong>Example</strong>:</p><div class="examples"><pre><code>{
|
|
174
|
"id": 4,
|
|
175
|
"firstName": "Pavel",
|
|
176
|
"lastName": "Fidransky",
|
|
177
|
"photo": "https://st2.depositphotos.com/9223672/12056/v/950/depositphotos_120568236-stock-illustration-male-face-avatar-logo-template.jpg",
|
|
178
|
"vacationCount": 0.0,
|
|
179
|
"sickDayCount": 5,
|
|
180
|
"takenSickDayCount": 0,
|
|
181
|
"status": "ACCEPTED",
|
|
182
|
"role": "EMPLOYEE",
|
|
183
|
"notification": "2019/12/01 12:00:00",
|
|
184
|
"email": "pavel.fidransky@yoso.fi"
|
|
185
|
}
|
|
186
|
</code></pre></div><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="users_current_profile_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_users__id__profile"><span class="parent">/users/{id}</span>/profile</a> <span class="methods"><a href="#users__id__profile_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_users__id__profile" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#users__id__profile_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="users__id__profile_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/users/{id}</span>/profile</h4></div><div class="modal-body"><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#users__id__profile_get_request" data-toggle="tab">Request</a></li><li><a href="#users__id__profile_get_response" data-toggle="tab">Response</a></li><li><a href="#users__id__profile_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="users__id__profile_get_request"><h3>URI Parameters</h3><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li></ul></div><div class="tab-pane" id="users__id__profile_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li><li><strong>firstName</strong>: <em><span class="required">required</span>(string)</em><p>the user's first name</p></li><li><strong>lastName</strong>: <em><span class="required">required</span>(string)</em><p>the user's last name</p></li><li><strong>photo</strong>: <em><span class="required">required</span>(string)</em><p>the URL of a photo</p></li><li><strong>vacationCount</strong>: <em><span class="required">required</span>(number)</em><p>the number of available vacations</p></li><li><strong>sickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of assigned sick days</p></li><li><strong>takenSickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of taken sick days</p></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em><p>the authorisation status</p></li><li><strong>role</strong>: <em><span class="required">required</span>(one of EMPLOYEE, EMPLOYER)</em><p>the user role</p></li><li><strong>notification</strong>: <em><span class="required">required</span>(string)</em><p>the notification of an incoming reset of remaining vacations and sick days in yyyy/mm/dd hh:mm:ss format</p></li><li><strong>email</strong>: <em><span class="required">required</span>(string)</em><p>the user's email address</p></li></ul><p><strong>Example</strong>:</p><div class="examples"><pre><code>{
|
|
187
|
"id": 4,
|
|
188
|
"firstName": "Pavel",
|
|
189
|
"lastName": "Fidransky",
|
|
190
|
"photo": "https://st2.depositphotos.com/9223672/12056/v/950/depositphotos_120568236-stock-illustration-male-face-avatar-logo-template.jpg",
|
|
191
|
"vacationCount": 0.0,
|
|
192
|
"sickDayCount": 5,
|
|
193
|
"takenSickDayCount": 0,
|
|
194
|
"status": "ACCEPTED",
|
|
195
|
"role": "EMPLOYEE",
|
|
196
|
"notification": "2019/12/01 12:00:00",
|
|
197
|
"email": "pavel.fidransky@yoso.fi"
|
|
198
|
}
|
|
199
|
</code></pre></div><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check URI parameters.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/404" target="_blank">404</a></h2><p>User with given ID doesn't exist.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="users__id__profile_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h3 id="user" class="panel-title">/user</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_user__id__calendar"><span class="parent">/user/{id}</span>/calendar</a> <span class="methods"><a href="#user__id__calendar_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_user__id__calendar" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#user__id__calendar_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer or calendar owner only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="user__id__calendar_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/user/{id}</span>/calendar</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer or calendar owner only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#user__id__calendar_get_request" data-toggle="tab">Request</a></li><li><a href="#user__id__calendar_get_response" data-toggle="tab">Response</a></li><li><a href="#user__id__calendar_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="user__id__calendar_get_request"><h3>URI Parameters</h3><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's id</p></li></ul><h3>Query Parameters</h3><ul><li><strong>from</strong>: <em><span class="required">required</span>(string)</em><p>yyyy/mm/dd</p></li><li><strong>to</strong>: <em>(string)</em><p>yyyy/mm/dd</p></li><li><strong>status</strong>: <em>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><div class="tab-pane" id="user__id__calendar_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: array of object</p><p><strong>Items</strong>: VacationDayDTO</p><div class="items"><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the id of the vacation/sick day</p></li><li><strong>date</strong>: <em><span class="required">required</span>(string)</em><p>the date of the vacation/sick day in yyyy/mm/dd format</p></li><li><strong>from</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the start of the vacation, null for sick days</p></li><li><strong>to</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the end of the vacation, null for sick days</p></li><li><strong>type</strong>: <em><span class="required">required</span>(one of VACATION, SICK_DAY)</em></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check query parameters.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/404" target="_blank">404</a></h2><p>User with given ID doesn't exist.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="user__id__calendar_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_user_calendar_create"><span class="parent">/user/calendar</span>/create</a> <span class="methods"><a href="#user_calendar_create_post"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_user_calendar_create" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#user_calendar_create_post'" class="list-group-item"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer or calendar owner only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="user_calendar_create_post"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/user/calendar</span>/create</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer or calendar owner only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#user_calendar_create_post_request" data-toggle="tab">Request</a></li><li><a href="#user_calendar_create_post_response" data-toggle="tab">Response</a></li><li><a href="#user_calendar_create_post_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="user_calendar_create_post_request"><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>date</strong>: <em><span class="required">required</span>(string)</em><p>the date of the vacation/sick day in yyyy/mm/dd format</p></li><li><strong>from</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the start of the vacation, null for sick days</p></li><li><strong>to</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the end of the vacation, null for sick days</p></li><li><strong>type</strong>: <em><span class="required">required</span>(one of VACATION, SICK_DAY)</em></li></ul></div><div class="tab-pane" id="user_calendar_create_post_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check request body.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="user_calendar_create_post_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_user_calendar_edit"><span class="parent">/user/calendar</span>/edit</a> <span class="methods"><a href="#user_calendar_edit_put"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_user_calendar_edit" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#user_calendar_edit_put'" class="list-group-item"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Denied to all.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="user_calendar_edit_put"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/user/calendar</span>/edit</h4></div><div class="modal-body"><div class="alert alert-info"><p>Denied to all.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#user_calendar_edit_put_request" data-toggle="tab">Request</a></li><li><a href="#user_calendar_edit_put_response" data-toggle="tab">Response</a></li><li><a href="#user_calendar_edit_put_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="user_calendar_edit_put_request"><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the id of the vacation/sick day</p></li><li><strong>date</strong>: <em><span class="required">required</span>(string)</em><p>the date of the vacation/sick day in yyyy/mm/dd format</p></li><li><strong>from</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the start of the vacation, null for sick days</p></li><li><strong>to</strong>: <em><span class="required">required</span>(union of string or nil)</em><p>the end of the vacation, null for sick days</p></li></ul></div><div class="tab-pane" id="user_calendar_edit_put_response"><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p></div><div class="tab-pane" id="user_calendar_edit_put_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_user_settings"><span class="parent">/user</span>/settings</a> <span class="methods"><a href="#user_settings_put"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_user_settings" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#user_settings_put'" class="list-group-item"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer or calendar owner only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="user_settings_put"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/user</span>/settings</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer or calendar owner only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#user_settings_put_request" data-toggle="tab">Request</a></li><li><a href="#user_settings_put_response" data-toggle="tab">Response</a></li><li><a href="#user_settings_put_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="user_settings_put_request"><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the user's ID</p></li><li><strong>vacationCount</strong>: <em><span class="required">required</span>(number)</em><p>the remaining vacations</p></li><li><strong>sickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of assigned sick days</p></li><li><strong>role</strong>: <em><span class="required">required</span>(one of EMPLOYEE, EMPLOYER)</em><p>the user role</p></li><li><strong>notification</strong>: <em><span class="required">required</span>(string)</em><p>the date and time of sending an email warning about an incoming reset of remaining overtimes and sick days</p></li></ul><p><strong>Example</strong>:</p><div class="examples"><pre><code>{
|
|
200
|
"id": 4,
|
|
201
|
"vacationCount": 0.0,
|
|
202
|
"sickDayCount": 5,
|
|
203
|
"role": "EMPLOYEE",
|
|
204
|
"notification": "2019/12/01 12:00:00"
|
|
205
|
}
|
|
206
|
</code></pre></div></div><div class="tab-pane" id="user_settings_put_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check request body.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="user_settings_put_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_user_requests"><span class="parent">/user</span>/requests</a> <span class="methods"><a href="#user_requests_put"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_user_requests" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#user_requests_put'" class="list-group-item"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="user_requests_put"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_put">put <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/user</span>/requests</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#user_requests_put_request" data-toggle="tab">Request</a></li><li><a href="#user_requests_put_response" data-toggle="tab">Response</a></li><li><a href="#user_requests_put_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="user_requests_put_request"><h3>Query Parameters</h3><ul><li><strong>type</strong>: <em><span class="required">required</span>(one of VACATION, AUTHORIZATION)</em></li></ul><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the id of the vacation/sick day</p></li><li><strong>status</strong>: <em><span class="required">required</span>(one of ACCEPTED, PENDING, REJECTED)</em></li></ul></div><div class="tab-pane" id="user_requests_put_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check query parameters and request body.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/404" target="_blank">404</a></h2><p>Neither vacation nor authorization request with given ID exists.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="user_requests_put_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h3 id="settings" class="panel-title">/settings</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_settings"><span class="parent"></span>/settings</a> <span class="methods"><a href="#settings_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a> <a href="#settings_post"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_settings" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#settings_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"></div><div class="clearfix"></div></div><div onclick="window.location.href = '#settings_post'" class="list-group-item"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="settings_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent"></span>/settings</h4></div><div class="modal-body"><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#settings_get_response" data-toggle="tab">Response</a></li><li><a href="#settings_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="settings_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>sickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of assigned sick days</p></li><li><strong>notification</strong>: <em><span class="required">required</span>(string)</em><p>the notification of an incoming reset of remaining vacations and sick days in yyyy/mm/dd hh:mm:ss format</p></li></ul><p><strong>Example</strong>:</p><div class="examples"><pre><code>{
|
|
207
|
"sickDayCount": 5,
|
|
208
|
"notification": "2019/12/01 12:00:00"
|
|
209
|
}
|
|
210
|
</code></pre></div><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="settings_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div><div class="modal fade" tabindex="0" id="settings_post"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent"></span>/settings</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#settings_post_request" data-toggle="tab">Request</a></li><li><a href="#settings_post_response" data-toggle="tab">Response</a></li><li><a href="#settings_post_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="settings_post_request"><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: object</p><strong>Properties</strong><ul><li><strong>sickDayCount</strong>: <em><span class="required">required</span>(integer)</em><p>the number of assigned sick days</p></li><li><strong>notification</strong>: <em><span class="required">required</span>(string)</em><p>the notification of an incoming reset of remaining vacations and sick days in yyyy/mm/dd hh:mm:ss format</p></li></ul><p><strong>Example</strong>:</p><div class="examples"><pre><code>{
|
|
211
|
"sickDayCount": 5,
|
|
212
|
"notification": "2019/12/01 12:00:00"
|
|
213
|
}
|
|
214
|
</code></pre></div></div><div class="tab-pane" id="settings_post_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="settings_post_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h3 id="calendar" class="panel-title">/calendar</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_calendar__id__delete"><span class="parent">/calendar/{id}</span>/delete</a> <span class="methods"><a href="#calendar__id__delete_delete"><span class="badge badge_delete">delete <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_calendar__id__delete" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#calendar__id__delete_delete'" class="list-group-item"><span class="badge badge_delete">delete <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"><p>Employer or vacation owner only.</p></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="calendar__id__delete_delete"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_delete">delete <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/calendar/{id}</span>/delete</h4></div><div class="modal-body"><div class="alert alert-info"><p>Employer or vacation owner only.</p></div><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#calendar__id__delete_delete_request" data-toggle="tab">Request</a></li><li><a href="#calendar__id__delete_delete_response" data-toggle="tab">Response</a></li><li><a href="#calendar__id__delete_delete_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="calendar__id__delete_delete_request"><h3>URI Parameters</h3><ul><li><strong>id</strong>: <em><span class="required">required</span>(integer)</em><p>the calendar's id</p></li></ul></div><div class="tab-pane" id="calendar__id__delete_delete_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p><h2>HTTP status code <a href="http://httpstatus.es/400" target="_blank">400</a></h2><p>Bad request. Check URI parameters and request body.</p><h2>HTTP status code <a href="http://httpstatus.es/401" target="_blank">401</a></h2><p>Not authenticated.</p><h2>HTTP status code <a href="http://httpstatus.es/403" target="_blank">403</a></h2><p>Not authorized.</p><h2>HTTP status code <a href="http://httpstatus.es/404" target="_blank">404</a></h2><p>Vacation with given ID doesn't exist.</p><h2>HTTP status code <a href="http://httpstatus.es/500" target="_blank">500</a></h2><p>Internal server error.</p></div><div class="tab-pane" id="calendar__id__delete_delete_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h3 id="import" class="panel-title">/import</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_import_xls"><span class="parent">/import</span>/xls</a> <span class="methods"><a href="#import_xls_post"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_import_xls" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#import_xls_post'" class="list-group-item"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="import_xls_post"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_post">post <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/import</span>/xls</h4></div><div class="modal-body"><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#import_xls_post_request" data-toggle="tab">Request</a></li><li><a href="#import_xls_post_response" data-toggle="tab">Response</a></li><li><a href="#import_xls_post_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="import_xls_post_request"><h3>Body</h3><p><strong>Media type</strong>: application/json</p><p><strong>Type</strong>: file</p></div><div class="tab-pane" id="import_xls_post_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p></div><div class="tab-pane" id="import_xls_post_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div><div class="panel panel-default"><div class="panel-heading"><h3 id="export" class="panel-title">/export</h3></div><div class="panel-body"><div class="panel-group"><div class="panel panel-white resource-modal"><div class="panel-heading"><h4 class="panel-title"><a class="collapsed" data-toggle="collapse" href="#panel_export_pdf"><span class="parent">/export</span>/pdf</a> <span class="methods"><a href="#export_pdf_get"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span></a></span></h4></div><div id="panel_export_pdf" class="panel-collapse collapse"><div class="panel-body"><div class="list-group"><div onclick="window.location.href = '#export_pdf_get'" class="list-group-item"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span><div class="method_description"></div><div class="clearfix"></div></div></div></div></div><div class="modal fade" tabindex="0" id="export_pdf_get"><div class="modal-dialog modal-lg"><div class="modal-content"><div class="modal-header"><button type="button" class="close" data-dismiss="modal" aria-hidden="true">×</button><h4 class="modal-title" id="myModalLabel"><span class="badge badge_get">get <span class="glyphicon glyphicon-lock" title="Authentication required"></span></span> <span class="parent">/export</span>/pdf</h4></div><div class="modal-body"><div class="alert alert-warning"><span class="glyphicon glyphicon-lock" title="Authentication required"></span> Secured by <b>oauth_2_0</b><p>Accessible with OAuth2 authentication token.</p></div><ul class="nav nav-tabs"><li class="active"><a href="#export_pdf_get_response" data-toggle="tab">Response</a></li><li><a href="#export_pdf_get_securedby" data-toggle="tab">Security</a></li></ul><div class="tab-content"><div class="tab-pane active" id="export_pdf_get_response"><h2>HTTP status code <a href="http://httpstatus.es/200" target="_blank">200</a></h2><p>OK.</p></div><div class="tab-pane" id="export_pdf_get_securedby"><h1>Secured by oauth_2_0</h1></div></div></div></div></div></div></div></div></div></div></div><div class="col-md-3"><div id="sidebar" class="hidden-print affix" role="complementary"><ul class="nav nav-pills nav-stacked"><li><a href="#users">/users</a></li><li><a href="#user">/user</a></li><li><a href="#settings">/settings</a></li><li><a href="#calendar">/calendar</a></li><li><a href="#import">/import</a></li><li><a href="#export">/export</a></li></ul></div></div></div></div></body></html>
|