스킬 정리 및 리팩토링

app/api/kis/domestic/overview/route.ts

@@ -1,14 +1,19 @@
 import { KOREAN_STOCK_INDEX } from "@/features/trade/data/korean-stocks";
 import type { DashboardStockOverviewResponse } from "@/features/trade/types/trade.types";
-import type { KisCredentialInput } from "@/lib/kis/config";
 import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
 import { hasKisApiSession } from "@/app/api/kis/_session";
 import { getDomesticOverview } from "@/lib/kis/domestic";
 import { NextRequest, NextResponse } from "next/server";
+import {
+  createKisApiErrorResponse,
+  KIS_API_ERROR_CODE,
+  toKisApiErrorMessage,
+} from "@/app/api/kis/_response";
 import {
   DOMESTIC_KIS_SESSION_OVERRIDE_HEADER,
   parseDomesticKisSession,
 } from "@/lib/kis/domestic-market-session";
+import { readKisCredentialsFromHeaders } from "@/app/api/kis/domestic/_shared";
 
 /**
  * @file app/api/kis/domestic/overview/route.ts
@@ -23,26 +28,33 @@ import {
 export async function GET(request: NextRequest) {
   const hasSession = await hasKisApiSession();
   if (!hasSession) {
-    return NextResponse.json({ error: "로그인이 필요합니다." }, { status: 401 });
+    return createKisApiErrorResponse({
+      status: 401,
+      code: KIS_API_ERROR_CODE.AUTH_REQUIRED,
+      message: "로그인이 필요합니다.",
+    });
   }
 
   const { searchParams } = new URL(request.url);
   const symbol = (searchParams.get("symbol") ?? "").trim();
 
   if (!/^\d{6}$/.test(symbol)) {
-    return NextResponse.json({ error: "symbol은 6자리 숫자여야 합니다." }, { status: 400 });
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.INVALID_REQUEST,
+      message: "symbol은 6자리 숫자여야 합니다.",
+    });
   }
 
   const credentials = readKisCredentialsFromHeaders(request.headers);
 
   if (!hasKisConfig(credentials)) {
-    return NextResponse.json(
-      {
-        error:
-          "대시보드 상단에서 KIS API 키를 입력하고 검증해 주세요. 키 정보가 없어서 시세를 조회할 수 없습니다.",
-      },
-      { status: 400 },
-    );
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.CREDENTIAL_REQUIRED,
+      message:
+        "대시보드 상단에서 KIS API 키를 입력하고 검증해 주세요. 키 정보가 없어서 시세를 조회할 수 없습니다.",
+    });
   }
 
   const fallbackMeta = KOREAN_STOCK_INDEX.find((item) => item.symbol === symbol);
@@ -71,28 +83,14 @@ export async function GET(request: NextRequest) {
       },
     });
   } catch (error) {
-    const message = error instanceof Error ? error.message : "KIS 조회 중 오류가 발생했습니다.";
-    return NextResponse.json({ error: message }, { status: 500 });
+    return createKisApiErrorResponse({
+      status: 500,
+      code: KIS_API_ERROR_CODE.UPSTREAM_FAILURE,
+      message: toKisApiErrorMessage(error, "KIS 조회 중 오류가 발생했습니다."),
+    });
   }
 }
 
-/**
- * 요청 헤더에서 KIS 키를 읽어옵니다.
- * @param headers 요청 헤더
- * @returns credentials
- */
-function readKisCredentialsFromHeaders(headers: Headers): KisCredentialInput {
-  const appKey = headers.get("x-kis-app-key")?.trim();
-  const appSecret = headers.get("x-kis-app-secret")?.trim();
-  const tradingEnv = normalizeTradingEnv(headers.get("x-kis-trading-env") ?? undefined);
-
-  return {
-    appKey,
-    appSecret,
-    tradingEnv,
-  };
-}
-
 function readSessionOverrideFromHeaders(headers: Headers) {
   if (process.env.NODE_ENV === "production") return null;
   const raw = headers.get(DOMESTIC_KIS_SESSION_OVERRIDE_HEADER);