Merge branch 'main' of http://39.117.244.52:3000/kjs/ERP-node into feature/report

frontend/lib/api/openApi.ts

@@ -0,0 +1,111 @@
+/**
+ * OpenAPI 클라이언트
+ * - 외부 API(날씨, 환율 등) 호출
+ */
+
+import { apiClient } from './client';
+
+// ============================================================
+// 타입 정의
+// ============================================================
+
+/**
+ * 날씨 정보
+ */
+export interface WeatherData {
+  city: string;
+  country: string;
+  temperature: number;
+  feelsLike: number;
+  humidity: number;
+  pressure: number;
+  weatherMain: string;
+  weatherDescription: string;
+  weatherIcon: string;
+  windSpeed: number;
+  clouds: number;
+  timestamp: string;
+}
+
+/**
+ * 환율 정보
+ */
+export interface ExchangeRateData {
+  base: string;
+  target: string;
+  rate: number;
+  timestamp: string;
+}
+
+/**
+ * Geocoding 결과
+ */
+export interface GeocodeData {
+  address: string;
+  lat: number;
+  lng: number;
+}
+
+/**
+ * API 응답 타입
+ */
+interface ApiResponse<T> {
+  success: boolean;
+  data: T;
+  message?: string;
+}
+
+// ============================================================
+// API 함수
+// ============================================================
+
+/**
+ * 날씨 정보 조회
+ * @param city 도시명 (기본값: Seoul)
+ * @param units 단위 (metric: 섭씨, imperial: 화씨)
+ * @param lang 언어 (kr: 한국어, en: 영어)
+ */
+export async function getWeather(
+  city: string = '서울',
+  units: string = 'metric',
+  lang: string = 'kr'
+): Promise<WeatherData> {
+  const response = await apiClient.get<ApiResponse<WeatherData>>(
+    `/open-api/weather`,
+    {
+      params: { city, units, lang },
+    }
+  );
+  return response.data.data;
+}
+
+/**
+ * 환율 정보 조회
+ * @param base 기준 통화 (기본값: KRW)
+ * @param target 대상 통화 (기본값: USD)
+ */
+export async function getExchangeRate(
+  base: string = 'KRW',
+  target: string = 'USD'
+): Promise<ExchangeRateData> {
+  const response = await apiClient.get<ApiResponse<ExchangeRateData>>(
+    `/open-api/exchange-rate`,
+    {
+      params: { base, target },
+    }
+  );
+  return response.data.data;
+}
+
+/**
+ * 주소를 좌표로 변환 (Geocoding)
+ * @param address 주소
+ */
+export async function geocode(address: string): Promise<GeocodeData> {
+  const response = await apiClient.post<ApiResponse<GeocodeData>>(
+    `/open-api/geocode`,
+    { address }
+  );
+  return response.data.data;
+}
+