taskana/history/taskana-simplehistory-rest-.../src/docs/asciidoc/simplehistory-rest-api.adoc

21 lines
1.1 KiB
Plaintext

= TASKANA History module RESTful API Documentation
== Overview
This is the REST documentation for http://taskana.pro)[TASKANA]'s simplehistory REST endpoints.
For all Query Parameters:: whenever a parameter is an array type multiple values can be passed by declaring that parameter multiple times.
=== Hypermedia Support
NOTE: HATEOAS support is still in development.
Please have a look at example responses for each resource to determine the available links.
TASKANA uses the https://restfulapi.net/hateoas/)[HATEOAS] (Hypermedia as the Engine of Application State) REST constraint.
Most of our resources contain a `_links` section which contains navigation links.
These navigation links not only help navigate through our REST API, they encapsulate API.
Using HATEOAS allows us to change some endpoints without breaking any frontend.
== History event
include::{snippets}/TaskHistoryEventControllerRestDocumentationTest/getAllTaskHistoryEventsDocTest/auto-section.adoc[]
include::{snippets}/TaskHistoryEventControllerRestDocumentationTest/getSpecificTaskHistoryEventDocTest/auto-section.adoc[]