docs: Improve Swagger JSDoc

2025-12-20 09:15:39 +03:00 · 2025-09-12 12:17:01 +02:00
parent 494800d131
commit b4979d214f
129 changed files with 294 additions and 248 deletions
--- a/server/api/controllers/webhooks/create.js
+++ b/server/api/controllers/webhooks/create.js
@@ -11,6 +11,7 @@
 *     description: Creates a webhook. Requires admin privileges.
 *     tags:
 *       - Webhooks
+ *     operationId: createWebhook
 *     requestBody:
 *       required: true
 *       content:
--- a/server/api/controllers/webhooks/delete.js
+++ b/server/api/controllers/webhooks/delete.js
@@ -11,6 +11,7 @@
 *     description: Deletes a webhook. Requires admin privileges.
 *     tags:
 *       - Webhooks
+ *     operationId: deleteWebhook
 *     parameters:
 *       - name: id
 *         in: path
--- a/server/api/controllers/webhooks/index.js
+++ b/server/api/controllers/webhooks/index.js
@@ -11,6 +11,7 @@
 *     description: Retrieves a list of all configured webhooks. Requires admin privileges.
 *     tags:
 *       - Webhooks
+ *     operationId: getWebhooks
 *     responses:
 *       200:
 *         description: List of webhooks retrieved successfully
--- a/server/api/controllers/webhooks/update.js
+++ b/server/api/controllers/webhooks/update.js
@@ -11,6 +11,7 @@
 *     description: Updates a webhook. Requires admin privileges.
 *     tags:
 *       - Webhooks
+ *     operationId: updateWebhook
 *     parameters:
 *       - name: id
 *         in: path