feat: improve OpenAPI request contracts and examples (#418)

* feat: improve OpenAPI request contracts and examples

* fix: align AJV docs plugin typing

* fix: preserve runtime behavior for OpenAPI schemas

* fix: align medication OpenAPI body schema with app payloads

backend/src/routes/api-keys.ts

@@ -167,6 +167,11 @@ export async function apiKeyRoutes(app: FastifyInstance) {
 						scope: { type: "string", enum: ["read", "write"], default: "write" },
 						expiresInDays: { type: "number", minimum: 1, maximum: 3650 },
 					},
+					example: {
+						name: "Home Assistant integration",
+						scope: "write",
+						expiresInDays: 365,
+					},
 				},
 				response: {
 					201: {