From b4118d6a2e2cf6d57430fe47d6c4a45b9f9817e8 Mon Sep 17 00:00:00 2001
From: San Kim <waterfog9580@gmail.com>
Date: Sat, 7 Dec 2024 20:23:11 +0900
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20=ED=94=84=EB=A1=9C=ED=95=84=20?=
 =?UTF-8?q?=EC=9D=B4=EB=AF=B8=EC=A7=80=20=EC=97=85=EB=A1=9C=EB=93=9C,=20?=
 =?UTF-8?q?=EC=82=AD=EC=A0=9C,=20=EC=A1=B0=ED=9A=8C=20API=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80=20(#38)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 🩹 extension required 추가

* ✨ 프로필 이미지 업로드, 삭제, 조회 API 추가
---
 openapi.yaml | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/openapi.yaml b/openapi.yaml
index 4990b1f..14ed35f 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -241,6 +241,32 @@ paths:
         '500':
           $ref: '#/components/responses/InternalServerError'
 
+  /users/my/profile-images/{imageId}:
+    delete:
+      summary: 프로필 이미지 삭제
+      description: 특정 프로필 이미지를 삭제합니다.
+      tags:
+        - users
+      operationId: deleteProfileImage
+      security:
+        - BearerAuth: [ ]
+      parameters:
+        - in: path
+          name: imageId
+          required: true
+          schema:
+            type: string
+            format: uuid
+          description: 삭제할 프로필 이미지 ID
+      responses:
+        '204':
+          description: 삭제 성공
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalServerError'
 
   /users/my/desiredPartner:
     put:
@@ -751,6 +777,11 @@ components:
         name:
           type: string
           description: 사용자 이름
+        profileImages:
+          type: array
+          description: 프로필 이미지 목록
+          items:
+            $ref: '#/components/schemas/ProfileImage'
         phoneNumber:
           type: string
           description: 사용자의 전화번호 (한국 휴대폰 번호 형식)
@@ -1150,6 +1181,7 @@ components:
           $ref: '#/components/schemas/ProfileImageExtension'
       required:
           - imageId
+          - extension
 
     ProfileWidget:
       type: object
@@ -1189,3 +1221,21 @@ components:
       type: string
       enum: [ PNG ]
       description: 프로필 이미지 확장자
+
+    ProfileImage:
+      type: object
+      properties:
+        id:
+          type: string
+          format: uuid
+          description: 이미지 식별자
+        url:
+          type: string
+          format: uri
+          description: 이미지 URL
+        extension:
+          $ref: '#/components/schemas/ProfileImageExtension'
+      required:
+        - id
+        - url
+        - extension