| 1 |
fe88b83e
|
Pavel Fidransky
|
<!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>
|