using System.Globalization; using System.Text.Json; namespace Infrastructure.StockData; /// /// 한국수출입은행 OpenAPI AP01(현재환율) 응답 파서 — 순수 C# (System.Text.Json). /// 응답 골격: 최상위가 JSON 배열 [ { result, cur_unit, cur_nm, ttb, tts, deal_bas_r, bkpr, kftc_deal_bas_r, ... }, ... ]. /// - result: 각 행의 조회 결과 코드 (1=성공, 2=DATA코드 오류, 3=인증코드 오류, 4=일일제한초과). result != 1 인 행은 skip. /// - 값은 전부 문자열, 천단위 콤마 포함 가능("1,392.50"). ttb/tts 는 미제공 시 빈값 → null. deal_bas_r 파싱 실패는 skip. /// - cur_unit 은 "USD" / "JPY(100)" / "IDR(100)" 처럼 "(100)" 단위 표기가 붙을 수 있으므로 원문 그대로 보존한다. /// koreaexim quirk: 주말/공휴일·영업일 오전(~11시) 이전엔 빈 배열([]) 을, 키/파라미터 오류 시 result 2~4 또는 빈 응답이 온다 → /// 어느 경우든 예외 없이 빈 목록을 돌려 배치가 "데이터 없음"으로 skip 하도록 한다. /// public static class KoreaEximExchangeParser { /// 환율 1행 (searchdate 는 호출부가 채움 — 응답에 날짜 필드가 없음) public sealed record ExchangeRow( string CurrencyUnit, string CurrencyName, decimal DealBasRate, decimal? Ttb, decimal? Tts ); public static IReadOnlyList Parse(string json) { var rows = new List(); if (string.IsNullOrWhiteSpace(json)) { return rows; } using var doc = JsonDocument.Parse(json); if (doc.RootElement.ValueKind != JsonValueKind.Array) { return rows; } foreach (var item in doc.RootElement.EnumerateArray()) { if (item.ValueKind != JsonValueKind.Object) { continue; } // result != 1 (성공 아님) 인 행은 건너뛴다 (2=DATA코드 오류 / 3=인증코드 오류 / 4=일일제한초과) if (GetInt(item, "result") != 1) { continue; } var curUnit = GetString(item, "cur_unit"); var dealBasRate = ParseNullableDecimal(GetString(item, "deal_bas_r")); if (curUnit.Length == 0 || dealBasRate is null) { continue; } rows.Add(new ExchangeRow( curUnit, GetString(item, "cur_nm"), dealBasRate.Value, ParseNullableDecimal(GetString(item, "ttb")), ParseNullableDecimal(GetString(item, "tts")) )); } return rows; } private static string GetString(JsonElement element, string name) { if (!element.TryGetProperty(name, out var value)) { return string.Empty; } return value.ValueKind switch { JsonValueKind.String => value.GetString()?.Trim() ?? string.Empty, JsonValueKind.Number => value.GetRawText(), _ => string.Empty }; } private static int GetInt(JsonElement element, string name) { if (!element.TryGetProperty(name, out var value)) { return 0; } return value.ValueKind switch { JsonValueKind.Number => value.TryGetInt32(out var n) ? n : 0, JsonValueKind.String => int.TryParse(value.GetString(), NumberStyles.Integer, CultureInfo.InvariantCulture, out var s) ? s : 0, _ => 0 }; } /// 환율/금액 문자열 → decimal (천단위 콤마 제거). "" 나 "-" 등 파싱 실패는 null. private static decimal? ParseNullableDecimal(string raw) { return decimal.TryParse(raw, NumberStyles.Float | NumberStyles.AllowThousands, CultureInfo.InvariantCulture, out var value) ? value : null; } }