From 7e9910ab8bbc4639f867ce386e1ca9db5b113a7f Mon Sep 17 00:00:00 2001
From: ruslan <r.semernin@gmail.com>
Date: Thu, 28 Sep 2023 09:52:45 +0300
Subject: [PATCH] APIv2 Idea: Added /purposes endpoint. Added /index query
 parameters.

---
 v2/swagger.yaml | 64 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)

diff --git a/v2/swagger.yaml b/v2/swagger.yaml
index 68f752b..7c3fe55 100644
--- a/v2/swagger.yaml
+++ b/v2/swagger.yaml
@@ -1551,12 +1551,61 @@ paths:
         500:
           description: Server Error.
 
+  /idea/purposes:
+    get:
+      tags:
+        - idea
+      summary: Idea purposes list.
+      operationId: /idea/purposes
+      responses:
+        200:
+          description: Idea purpose object.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ideaPurposes'
+        401:
+          description: Unauthorized request.
+        403:
+          description: Unauthorized request.
+        500:
+          description: Server Error.
+
   /idea/index:
     get:
       tags:
         - idea
       summary: Idea index.
       operationId: /idea/index
+      parameters:
+        - name: created_at
+          in: query
+          description: Дата создания идеи.
+          schema:
+            type: string
+          required: false
+          example: 2023-01-01|2023-01-01
+        - name: created_user_id
+          in: query
+          description: Идентификатор пользователя. Можно передать несколько идентификаторов разделенные запятой.
+          schema:
+            type: string
+          required: false
+          example: edee4e11-dab5-4aac-93ac-43c379aab6b2
+        - name: idea_status_id
+          in: query
+          description: Статус идеи. Можно передать несколько идентификаторов разделенные запятой.
+          schema:
+            type: integer
+          required: false
+          example: 1
+        - name: idea_purpose_id
+          in: query
+          description: Направление идеи. Можно передать несколько идентификаторов разделенные запятой.
+          schema:
+            type: string
+          required: false
+          example: edee4e11-dab5-4aac-93ac-43c379aab6b2
       responses:
         200:
           description: Idea objects.
@@ -3601,6 +3650,21 @@ components:
             type: string
             example: Модерация
 
+    ideaPurposes:
+      description: Список направлений идеи.
+      type: array
+      items:
+        properties:
+          id:
+            description: Идентификатор направления.
+            type: string
+            format: uuid
+            example: a91fe4d9-b486-4e94-9114-18589aad7c7e
+          name:
+            description: Имя направления.
+            type: string
+            example: Направление
+
     ideaIndex:
       type: object
       properties: