using System.Globalization; using System.Text.Json; namespace Infrastructure.StockData; /// /// 한국수출입은행 OpenAPI AP02(대출금리) / AP03(국제금리) 응답 파서 — 순수 C# (System.Text.Json). /// 응답 골격: 최상위가 JSON 배열 [ { result, cur_nm(항목명), … 금리 수치 필드 }, ... ]. (AP01 환율과 같은 배열 shape, 필드만 다름) /// - result: 각 행의 조회 결과 코드 (1=성공). result != 1 인 행은 skip (2~4 = DATA/인증/제한 오류). /// - ItemName ← cur_nm (또는 대응 항목명 필드). 값은 전부 문자열, 천단위 콤마/빈값 가능. /// - Rate ← 항목의 금리 수치. koreaexim 금리 응답은 종류별로 수치 필드명이 달라, 알려진 후보 필드를 순서대로 탐색해 /// 처음 파싱되는 숫자를 대표 금리로 삼는다 (deal_bas_r, ttb, tts, bkpr 등). 아무 것도 없으면 Rate=null (항목만 보존). /// koreaexim quirk: 주말/공휴일·오전 이전엔 빈 배열([]), 키/파라미터 오류 시 result 2~4 또는 빈 응답 → 예외 없이 빈 목록 반환. /// public static class KoreaEximRateParser { /// 금리 1행 (searchdate 는 호출부가 채움). Rate 는 미고시 시 null. public sealed record RateRow( string ItemName, decimal? Rate ); // 금리 수치가 담길 수 있는 후보 필드 (순서대로 첫 파싱 성공값을 채택) private static readonly string[] RateFields = ["deal_bas_r", "ttb", "tts", "bkpr", "kftc_deal_bas_r"]; // 항목명이 담길 수 있는 후보 필드 private static readonly string[] NameFields = ["cur_nm", "cur_unit", "item_nm"]; 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; } if (GetInt(item, "result") != 1) { continue; } var itemName = FirstNonEmpty(item, NameFields); if (itemName.Length == 0) { continue; } rows.Add(new RateRow(itemName, FirstRate(item, RateFields))); } return rows; } private static string FirstNonEmpty(JsonElement element, string[] fields) { foreach (var field in fields) { var value = GetString(element, field); if (value.Length > 0) { return value; } } return string.Empty; } private static decimal? FirstRate(JsonElement element, string[] fields) { foreach (var field in fields) { var value = ParseNullableDecimal(GetString(element, field)); if (value is not null) { return value; } } return null; } 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; } }