Add comprehensive OpenAPI 3.0 documentation for the API#1

Copilot wants to merge 7 commits intomainPackjackisback/homeaccess-api:mainfrom

copilot/document-api-with-openapiPackjackisback/homeaccess-api:copilot/document-api-with-openapiCopy head branch name to clipboard