디자인 변경

features/dashboard/apis/kis-auth.api.ts

@@ -5,77 +5,77 @@ import type {
   DashboardKisWsApprovalResponse,
 } from "@/features/dashboard/types/dashboard.types";
 
+interface KisApiBaseResponse {
+  ok: boolean;
+  message: string;
+}
+
+async function postKisAuthApi<T extends KisApiBaseResponse>(
+  endpoint: string,
+  credentials: KisRuntimeCredentials,
+  fallbackErrorMessage: string,
+): Promise<T> {
+  const response = await fetch(endpoint, {
+    method: "POST",
+    headers: {
+      "content-type": "application/json",
+    },
+    body: JSON.stringify(credentials),
+    cache: "no-store",
+  });
+
+  const payload = (await response.json()) as T;
+
+  if (!response.ok || !payload.ok) {
+    throw new Error(payload.message || fallbackErrorMessage);
+  }
+
+  return payload;
+}
+
 /**
- * KIS API 키 검증 요청
- * @param credentials 검증할 키 정보
+ * @description KIS API 키를 검증합니다.
+ * @see app/api/kis/validate/route.ts
  */
 export async function validateKisCredentials(
   credentials: KisRuntimeCredentials,
 ): Promise<DashboardKisValidateResponse> {
-  const response = await fetch("/api/kis/validate", {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-    },
-    body: JSON.stringify(credentials),
-    cache: "no-store",
-  });
-
-  const payload = (await response.json()) as DashboardKisValidateResponse;
-
-  if (!response.ok || !payload.ok) {
-    throw new Error(payload.message || "API 키 검증에 실패했습니다.");
-  }
-
-  return payload;
+  return postKisAuthApi<DashboardKisValidateResponse>(
+    "/api/kis/validate",
+    credentials,
+    "API 키 검증에 실패했습니다.",
+  );
 }
 
 /**
- * KIS 접근토큰 폐기 요청
- * @param credentials 폐기할 키 정보
+ * @description KIS 액세스 토큰을 폐기합니다.
+ * @see app/api/kis/revoke/route.ts
  */
 export async function revokeKisCredentials(
   credentials: KisRuntimeCredentials,
 ): Promise<DashboardKisRevokeResponse> {
-  const response = await fetch("/api/kis/revoke", {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-    },
-    body: JSON.stringify(credentials),
-    cache: "no-store",
-  });
-
-  const payload = (await response.json()) as DashboardKisRevokeResponse;
-
-  if (!response.ok || !payload.ok) {
-    throw new Error(payload.message || "API 키 접근 폐기에 실패했습니다.");
-  }
-
-  return payload;
+  return postKisAuthApi<DashboardKisRevokeResponse>(
+    "/api/kis/revoke",
+    credentials,
+    "API 토큰 폐기에 실패했습니다.",
+  );
 }
 
 /**
- * KIS 실시간 웹소켓 승인키 발급 요청
- * @param credentials 인증 정보
+ * @description 웹소켓 승인키와 WS URL을 조회합니다.
+ * @see app/api/kis/ws/approval/route.ts
  */
 export async function fetchKisWebSocketApproval(
   credentials: KisRuntimeCredentials,
 ): Promise<DashboardKisWsApprovalResponse> {
-  const response = await fetch("/api/kis/ws/approval", {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-    },
-    body: JSON.stringify(credentials),
-    cache: "no-store",
-  });
+  const payload = await postKisAuthApi<DashboardKisWsApprovalResponse>(
+    "/api/kis/ws/approval",
+    credentials,
+    "웹소켓 승인키 발급에 실패했습니다.",
+  );
 
-  const payload = (await response.json()) as DashboardKisWsApprovalResponse;
-  if (!response.ok || !payload.ok || !payload.approvalKey || !payload.wsUrl) {
-    throw new Error(
-      payload.message || "KIS 실시간 웹소켓 승인키 발급에 실패했습니다.",
-    );
+  if (!payload.approvalKey || !payload.wsUrl) {
+    throw new Error(payload.message || "웹소켓 연결 정보가 누락되었습니다.");
   }
 
   return payload;