= Rest API Documentation - Authentication
minerva
v{project-version} {build-time}
:toc: left
:sectnums:

== Login
Login to the system. If credentials are invalid response with 403 status code will be returned. Token will be valid for the next 120 minutes.

=== CURL sample
include::{snippets}/authentication/login/curl-request.adoc[]

=== Request Parameters
include::{snippets}/authentication/login/request-parameters.adoc[]

=== Response Fields
include::{snippets}/authentication/login/response-fields.adoc[]

=== Sample Response
include::{snippets}/authentication/login/response-body.adoc[]


== Logout
Logout from the system.

=== CURL sample
include::{snippets}/authentication/logout/curl-request.adoc[]

=== Response Fields
include::{snippets}/authentication/logout/response-fields.adoc[]

=== Sample Response
include::{snippets}/authentication/logout/response-body.adoc[]


== Check if session is still valid
Sometimes there is need for verification if user is authenticated in the current session (for instance we might need this information to check if our session did not expire). This API call returns information if the session is still valid.

=== CURL sample
include::{snippets}/authentication/isSessionValid/curl-request.adoc[]

=== Response Fields
include::{snippets}/authentication/isSessionValid/response-fields.adoc[]

=== Sample Response
include::{snippets}/authentication/isSessionValid/response-body.adoc[]