Added GET /actions api definition into openapi.yaml

Author: ch00z00

openapi.yaml

@@ -622,6 +622,50 @@ paths:
       schema:
        $ref: "#/components/schemas/Error"
  # GET /actions は要件に応じてフィルタリングパラメータ（例: goal_id, user_id, date_range）を追加検討
+ get:
+  summary: 指定された目標IDに紐づく行動の一覧を取得
+  tags:
+   - Actions
+  security:
+   - BearerAuth: []
+  parameters:
+   - name: goal_id
+     in: query
+     required: true
+     description: 行動を取得する対象の目標ID
+     schema:
+      type: integer
+      format: int64
+      example: 1
+  responses:
+   "200":
+    description: 行動一覧の取得成功
+    content:
+     application/json:
+      schema:
+       type: array
+       items:
+        $ref: "#/components/schemas/Action"
+   "400":
+    description: リクエスト不正 (goal_idが指定されていない、または無効など)
+    content:
+     application/json:
+      schema:
+       $ref: "#/components/schemas/Error"
+   "401":
+    description: 認証エラー
+    content:
+     application/json:
+      schema:
+       $ref: "#/components/schemas/Error"
+   "404":
+    description: 指定された目標が見つからない、またはその目標に紐づく行動が存在しない
+   "500":
+    description: サーバー内部エラー
+    content:
+     application/json:
+      schema:
+       $ref: "#/components/schemas/Error"
 
  /badges:
   get: