upd: api ai

Deskripsi:
- perbaiki get data
- api ai data desa
- api ai version app

No Issues

darmasaba-api-ai.yml

@@ -33,19 +33,34 @@ components:
         message:
           type: string
           description: Response message or error description
-        meta:
-          type: object
+
+    # Village
+    VillageListResponse:
+      allOf:
+        - $ref: "#/components/schemas/BaseResponse"
+        - type: object
           properties:
-            total:
-              type: integer
-              description: Total number of items
-            page:
-              type: integer
-              description: Current page number
-            get:
-              type: integer
-              description: Number of items per page
-          description: Pagination metadata
+            data:
+              type: array
+              items:
+                properties:
+                  id:
+                    type: string
+                    description: Unique identifier for the village
+                  name:
+                    type: string
+                    description: Name of the village
+                  isActive:
+                    type: boolean
+                    description: Indicates whether the village is active
+                  createdAt:
+                    type: string
+                    format: date-time
+                    description: Timestamp when the village was created
+                  updatedAt:
+                    type: string
+                    format: date-time
+                    description: Timestamp when the village was last updatedØ
 
     # Banner
     BannerBase:
@@ -1393,6 +1408,48 @@ components:
               description: Details of a specific user
 
 paths:
+  # Village
+  /village:
+    get:
+      tags:
+        - Village
+      summary: Get list of villages
+      description: Retrieves a paginated list of villages filtered by search term and active status
+      parameters:
+        - name: search
+          in: query
+          description: Search term for village name
+          schema:
+            type: string
+            nullable: true
+        - name: active
+          in: query
+          description: Filter by active status
+          schema:
+            type: boolean
+            nullable: true
+        - name: page
+          in: query
+          description: Page number for pagination
+          schema:
+            type: integer
+            minimum: 1
+            default: 1
+        - name: get
+          in: query
+          description: Number of items per page
+          schema:
+            type: integer
+            minimum: 1
+            default: 10
+      responses:
+        "200":
+          description: List of villages
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/VillageListResponse"
+
   # Announcement
   /announcement:
     get:
@@ -1420,7 +1477,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -1501,7 +1558,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -1601,7 +1658,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -1695,7 +1752,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -1789,7 +1846,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -1894,7 +1951,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2058,7 +2115,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2112,7 +2169,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2172,7 +2229,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2233,7 +2290,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2335,7 +2392,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2436,7 +2493,7 @@ paths:
             type: integer
             minimum: 1
             default: 1
-        - name: perPage
+        - name: get
           in: query
           description: Number of items per page
           schema:
@@ -2488,6 +2545,8 @@ security:
   - bearerAuth: []
 
 tags:
+  - name: Village
+    description: Operations related to village management
   - name: Announcement
     description: Operations related to announcements
   - name: Banner