Make internal API docs use OpenAPI 3.0 instead of 2.x (=Swagger)

[mountaindude]

Fastify v4 has improved support for creating documentation in OpenAPI 3.x format.
This requires some rework of the API definition files in the src/api folder. Specifically, the files in that folder must use correct JSON schema syntax.