Fix OpenAPI specs

[Petitoto]

Description

This PR fixes OpenAPI specs, with the aim to be fully compatible with several API clients like Hoppscotch.

This includes:

• the fix of an invalid endpoint, which should always start with / (see https://learn.openapis.org/specification/paths.html#the-endpoints-list)
• the fix of the invalid security scheme_name, which should match ^[a-zA-Z0-9\.\-_]+$ (see https://spec.openapis.org/oas/latest.html#fixed-fields-5)
• automatically set operationId to the path for each route
• add name and version to the OpenAPI specifications
• add HYPERION_VERSION and MINIMAL_TITAN_VERSION_CODE to .env

Checklist

• Created tests which fail without the change (if possible)
• All tests passing
• Extended the documentation, if necessary

Breaking change

Remove PostmanAuthClient

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 80.45%. Comparing base (3a87006) to head (f36c8e9).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #390      +/-   ##
==========================================
+ Coverage   80.43%   80.45%   +0.02%     
==========================================
  Files          85       85              
  Lines        5790     5797       +7     
==========================================
+ Hits         4657     4664       +7     
  Misses       1133     1133              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[julien4215]

Why are we moving versions numbers and code to .env ? (see Armand's comment below)

In my opinion these fields should be hardcoded and not based on the dotenv. The MINIMAL_TITAN_VERSION_CODE is known during development and not deployement.

[armanddidierjean]

Brilliant, thanks @Petitoto!