feat(api)!: normalize endpoints, add Swagger annotations

[codacy-production[bot]]

Coverage summary from Codacy

See diff coverage on Codacy

Coverage variation	Diff coverage
:white_check_mark: +0.00%	:white_check_mark: 100.00%

Coverage variation details

| | Coverable lines | Covered lines | Coverage | | ------------- | ------------- | ------------- | ------------- | | Common ancestor commit (84704eba84085c534bc7f224618d65561a0b174d) | 62 | 62 | 100.00% | | | Head commit (6c8e790478452f5f6cc1fbe87cd8bcbe75663b96) | 62 (+0) | 62 (+0) | 100.00% (**+0.00%**) | **Coverage variation** is the difference between the coverage for the head and common ancestor commits of the pull request branch: ` - `

Diff coverage details

| | Coverable lines | Covered lines | Diff coverage | | ------------- | ------------- | ------------- | ------------- | | Pull request (#127) | 1 | 1 | **100.00%** | **Diff coverage** is the percentage of lines that are covered by tests out of the coverable lines that the pull request added or modified: `/ * 100%`

See your quality gate settings    Change summary preferences

---

_{:rocket: Don’t miss a bit, follow what’s new on Codacy.}

_{Codacy stopped sending the deprecated coverage status on June 5th, 2024. Learn more}

[codeclimate[bot]]

Code Climate has analyzed commit 6c8e7904 and detected 0 issues on this pull request.

View more on Code Climate.

[codecov[bot]]

Codecov Report

All modified and coverable lines are covered by tests :white_check_mark:

Project coverage is 96.77%. Comparing base (84704eb) to head (6c8e790).

Additional details and impacted files

```diff @@ Coverage Diff @@ ## master #127 +/- ## ========================================= Coverage 96.77% 96.77% Complexity 25 25 ========================================= Files 2 2 Lines 62 62 Branches 8 8 ========================================= Hits 60 60 Partials 2 2 ```

:umbrella: View full report in Codecov by Sentry.
:loudspeaker: Have feedback on the report? Share it here.