Write API specifications

[genericSpecimen]

Write API specifications to provide an overview of the functionality of the API, and the expected results.

Suggested fields:

• API name and version
• Description of all resources, endpoints, HTTP methods, all input parameters, response codes

[genericSpecimen]

Trying a 'Code First' API Documentation approach with springdoc-openapi and special annotations - bea2ab531296a99b821b58c95b948029fcbf0618

Auto-generated API spec is currently available at the following links after application start-up:

• Swagger UI: http://localhost:8080/swagger-ui.html
• OpenAPI v3 (JSON): http://localhost:8080/v3/api-docs