kpubdata 0.2.1__tar.gz → 0.2.3__tar.gz

{kpubdata-0.2.1 → kpubdata-0.2.3}/ARCHITECTURE.md

@@ -210,46 +210,26 @@ sequenceDiagram
 
 **핵심 메서드**: 모든 어댑터는 `_require_api_key()` → `self._config.require_provider_key("slug")` 패턴을 사용합니다.
 
-### 6.4 기관별 키 주입 방식
+## 7. 페이지네이션 전략 (Pagination Strategy)
 
-기관마다 키를 HTTP 요청에 넣는 위치와 파라미터 이름이 다릅니다.
+KPubData는 대량의 데이터를 효율적으로 가져오기 위해 두 가지 페이지네이션 전략을 사용합니다.
 
-| Provider | 파라미터 이름 | 주입 위치 | 예시 | 특이사항 |
-|---|---|---|---|---|
-| `datago` | `serviceKey` | Query parameter | `?serviceKey=KEY` | dataset별 `service_key_param` 메타데이터로 파라미터명 오버라이드 가능 |
-| `bok` | _(URL 경로)_ | URL path segment | `/{KEY}/json/{operation}/...` | 쿼리 파라미터가 아닌 **URL 경로**에 직접 삽입 |
-| `kosis` | `apiKey` | Query parameter | `?apiKey=KEY` | 표준적인 쿼리 파라미터 방식 |
-| `lofin` | `Key` | Query parameter | `?Key=KEY` | 대문자 `K` 필수. `Type=json`도 대문자 `T` 필수 |
+### 7.1 전략 종류
+- **오프셋 기반 (Offset-based)**: 페이지 번호를 이용해 데이터를 요청합니다. `next_page` 값이 반환됩니다.
+- **커서 기반 (Cursor-based)**: 특정 지점을 가리키는 포인터(커서)를 이용해 다음 데이터를 요청합니다. `next_cursor` 값이 반환됩니다.
 
-```text
-datago:  GET https://apis.data.go.kr/.../getVilageFcst?serviceKey=KEY&...
-bok:     GET https://ecos.bok.or.kr/api/KEY/json/StatisticSearch/...
-kosis:   GET https://kosis.kr/openapi/Idx/indikatorList.do?apiKey=KEY&...
-lofin:   GET https://www.lofin365.go.kr/lf/hub/AJGCF?Key=KEY&Type=json&...
-```
-
-### 6.5 새 어댑터 추가 시 인증 구현 가이드
-
-새로운 데이터 기관을 추가할 때, 인증 관련 구현은 다음 3단계를 따릅니다.
-
-**1단계**: `_require_api_key()` 메서드를 정의합니다.
-```python
-def _require_api_key(self) -> str:
-    return self._config.require_provider_key("your_provider_slug")
-```
+### 7.2 동작 원리 및 휴리스틱 (Heuristic)
+어댑터는 가용한 정보에 따라 다음과 같이 다음 페이지 존재 여부를 결정합니다.
+1. **정밀 계산**: `total_count` 정보를 알 수 있는 경우(예: bok, lofin), 현재까지 가져온 개수와 전체 개수를 비교해 `next_page`를 정확히 계산합니다.
+2. **Best-effort 휴리스틱**: 전체 개수 정보가 없는 경우(예: datago), `len(items) == page_size` 공식을 사용합니다.
+   - 현재 페이지의 아이템 개수가 요청한 페이지 크기와 같다면, 다음 페이지가 더 있을 것으로 가정합니다.
+   - 이 방식은 마지막 데이터가 딱 페이지 크기에 맞춰 끝날 경우, 실제로 데이터가 없는 다음 페이지를 한 번 더 호출하는 **추가 fetch(Extra empty fetch)**가 발생할 수 있습니다. 이는 문서화된 트레이드오프(trade-off)입니다.
 
-**2단계**: 요청 생성 시 키를 해당 기관의 방식에 맞게 주입합니다.
-```python
-# Query parameter 방식 (가장 일반적)
-params = {"apiKey": self._require_api_key(), ...}
-
-# URL path 방식 (bok처럼 경로에 넣는 경우)
-url = f"{base_url}/{self._require_api_key()}/json/{operation}"
-```
+### 7.3 list_all()의 처리
+사용자가 `list_all()` 메서드를 호출하면, KPubData는 어댑터가 반환하는 전략(`next_cursor` 우선, 없으면 `next_page`)을 자동으로 판단하여 모든 데이터를 순회합니다.
 
-**3단계**: `Client`의 `_BUILTIN_PROVIDERS` 튜플에 등록하면, `from_env()`가 자동으로 `KPUBDATA_{SLUG}_API_KEY` 환경변수를 스캔합니다.
+## 8. 자주 묻는 질문 (FAQ)
 
-## 7. 자주 묻는 질문 (FAQ)
 
 **Q: 새 데이터셋을 추가하려면 어디를 수정하나요?**
 A: 해당 기관의 어댑터(`providers/<provider>/adapter.py`)와 데이터 목록 파일(`catalogue.json`)을 수정하면 됩니다.

{kpubdata-0.2.1 → kpubdata-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kpubdata
-Version: 0.2.1
+Version: 0.2.3
 Summary: Dialect-inspired Python access framework for Korean public data
 Author: Yeongseon Choe
 License: MIT
@@ -340,6 +340,13 @@ print(df.head())
 | 공공데이터포털 (`datago`) | 버스도착정보 (`bus_arrival`) | 지원 |
 | 공공데이터포털 (`datago`) | 병원정보 (`hospital_info`) | 지원 |
 | 공공데이터포털 (`datago`) | 아파트매매 실거래가 (`apt_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 아파트 전월세 실거래가 (`apt_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 오피스텔 매매 실거래가 (`offi_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 오피스텔 전월세 실거래가 (`offi_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 연립다세대 매매 실거래가 (`rh_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 연립다세대 전월세 실거래가 (`rh_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 단독/다가구 매매 실거래가 (`sh_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 단독/다가구 전월세 실거래가 (`sh_rent`) | 지원 |
 | 한국은행 ECOS (`bok`) | 기준금리 (`base_rate`) | 지원 |
 | 통계청 KOSIS (`kosis`) | 인구이동 (`population_migration`) | 지원 |
 | 지방재정365 (`lofin`) | 세출결산총괄 (`expenditure_budget`) | 지원 |
@@ -412,4 +419,3 @@ KPubData의 설계 철학과 사용 방법을 안내하는 문서 목록입니
 
 ### v0.3
 - 표준 코어를 기반으로 한 경량 [MCP](https://modelcontextprotocol.io/)(Model Context Protocol — AI 모델이 외부 도구를 사용하는 표준 규약) 어댑터 지원
-

{kpubdata-0.2.1 → kpubdata-0.2.3}/PROVIDER_ADAPTER_CONTRACT.md

@@ -167,7 +167,15 @@ classDiagram
     }
 ```
 
-## 4. Capability rules
+## 4. 페이지네이션 반환 규약 (Pagination Return Contract)
+
+어댑터는 `query_records` 결과로 반환되는 `RecordBatch`에 다음 페이지 정보를 포함해야 합니다.
+
+- **`next_page` 또는 `next_cursor` 반환**: 어댑터는 반드시 둘 중 하나를 반환하거나, 마지막 페이지인 경우 둘 다 `None`을 반환해야 합니다.
+- **우선순위**: `list_all()`은 `next_cursor`가 존재할 경우 이를 우선적으로 사용하며, 없을 경우 `next_page`를 사용합니다.
+- **권장 방식**: 가급적 `total_count` 기반의 정밀한 계산 방식을 선호합니다. 하지만 전체 개수 정보를 알 수 없는 경우 `len(items) == page_size` 휴리스틱을 사용하는 것도 허용됩니다.
+
+## 5. Capability rules
 
 - declare only what the adapter truly supports
 - if an operation is unavailable, raise `UnsupportedCapabilityError`

{kpubdata-0.2.1 → kpubdata-0.2.3}/README.md

@@ -303,6 +303,13 @@ print(df.head())
 | 공공데이터포털 (`datago`) | 버스도착정보 (`bus_arrival`) | 지원 |
 | 공공데이터포털 (`datago`) | 병원정보 (`hospital_info`) | 지원 |
 | 공공데이터포털 (`datago`) | 아파트매매 실거래가 (`apt_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 아파트 전월세 실거래가 (`apt_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 오피스텔 매매 실거래가 (`offi_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 오피스텔 전월세 실거래가 (`offi_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 연립다세대 매매 실거래가 (`rh_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 연립다세대 전월세 실거래가 (`rh_rent`) | 지원 |
+| 공공데이터포털 (`datago`) | 단독/다가구 매매 실거래가 (`sh_trade`) | 지원 |
+| 공공데이터포털 (`datago`) | 단독/다가구 전월세 실거래가 (`sh_rent`) | 지원 |
 | 한국은행 ECOS (`bok`) | 기준금리 (`base_rate`) | 지원 |
 | 통계청 KOSIS (`kosis`) | 인구이동 (`population_migration`) | 지원 |
 | 지방재정365 (`lofin`) | 세출결산총괄 (`expenditure_budget`) | 지원 |
@@ -375,4 +382,3 @@ KPubData의 설계 철학과 사용 방법을 안내하는 문서 목록입니
 
 ### v0.3
 - 표준 코어를 기반으로 한 경량 [MCP](https://modelcontextprotocol.io/)(Model Context Protocol — AI 모델이 외부 도구를 사용하는 표준 규약) 어댑터 지원
-

{kpubdata-0.2.1 → kpubdata-0.2.3}/SUPPORTED_DATA.md

@@ -23,6 +23,13 @@
 | 상태 | 검증 | 실API 최종 검증일 | Provider | Dataset ID | 데이터셋명 | 인증 | 공식 문서 | 비고 |
 |---|---|---|---|---|---|---|---|---|
 | 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `apt_trade` | 아파트매매 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `apt_rent` | 아파트 전월세 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `offi_trade` | 오피스텔 매매 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `offi_rent` | 오피스텔 전월세 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `rh_trade` | 연립다세대 매매 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `rh_rent` | 연립다세대 전월세 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `sh_trade` | 단독/다가구 매매 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
+| 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `sh_rent` | 단독/다가구 전월세 실거래가 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 국토교통부 제공 |
 | 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `village_fcst` | 단기예보 조회서비스 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 기상청 제공 |
 | 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `ultra_srt_ncst` | 초단기실황 조회서비스 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | 기상청 제공 |
 | 지원 | 테스트 검증 | - | 공공데이터포털 (`datago`) | `air_quality` | 대기오염정보 조회서비스 | [공공데이터포털](https://www.data.go.kr) 서비스키 | [data.go.kr](https://www.data.go.kr) | |
@@ -41,7 +48,6 @@
 
 | 상태 | Provider | Dataset ID | 데이터셋명 | 메모 |
 |---|---|---|---|---|
-| 예정 | 공공데이터포털 (`datago`) | `apt_rent` | 아파트 전월세 실거래가 | `apt_trade`와 인접한 확장 후보 |
 | 예정 | 기상청 | `weather_forecast` | 동네예보 | provider/adapter 구조 확정 후 착수 |
 
 ## 갱신 규칙

{kpubdata-0.2.1 → kpubdata-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kpubdata"
-version = "0.2.1"
+version = "0.2.3"
 description = "Dialect-inspired Python access framework for Korean public data"
 readme = "README.md"
 requires-python = ">=3.10"

{kpubdata-0.2.1 → kpubdata-0.2.3}/src/kpubdata/core/dataset.py

@@ -135,8 +135,13 @@ class Dataset:
         page_kwargs = dict(kwargs)
         batch = self.list(**page_kwargs)
         yield batch
-        while batch.next_page is not None:
-            page_kwargs["page"] = batch.next_page
+        while batch.next_page is not None or batch.next_cursor is not None:
+            if batch.next_cursor is not None:
+                page_kwargs["cursor"] = batch.next_cursor
+                _ = page_kwargs.pop("page", None)
+            else:
+                page_kwargs["page"] = batch.next_page
+                _ = page_kwargs.pop("cursor", None)
             batch = self.list(**page_kwargs)
             yield batch
 

{kpubdata-0.2.1 → kpubdata-0.2.3}/src/kpubdata/providers/datago/adapter.py

@@ -29,6 +29,19 @@ from kpubdata.transport.http import HttpTransport, TransportConfig
 logger = logging.getLogger("kpubdata.provider.datago")
 
 
+def _is_success_code(code: str) -> bool:
+    """Return True for any data.go.kr resultCode that signals success.
+
+    Different endpoint families use different widths for the "no error" code:
+    "00" (most APIs) and "000" (RTMS family under apis.data.go.kr/1613000).
+    Both — and any zero-valued numeric variant — should be treated as success.
+    """
+    try:
+        return int(code) == 0
+    except ValueError:
+        return False
+
+
 class DataGoAdapter:
     """Adapter for data.go.kr (공공데이터포털).
 
@@ -245,7 +258,7 @@ class DataGoAdapter:
             "data.go.kr result",
             extra={"result_code": result_code, "result_msg": result_msg, "dataset_id": dataset_id},
         )
-        if result_code != "00":
+        if not _is_success_code(result_code):
             self._raise_for_result_code(result_code, result_msg, dataset_id)
 
         body_obj = response_dict.get("body")

kpubdata-0.2.3/src/kpubdata/providers/datago/catalogue.json

@@ -0,0 +1,197 @@
+[
+  {
+    "dataset_key": "village_fcst",
+    "name": "동네예보 조회서비스 (Village Forecast)",
+    "base_url": "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0",
+    "default_operation": "getVilageFcst",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "dataType",
+    "description": "Korea Meteorological Administration short-range forecast",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "ultra_srt_ncst",
+    "name": "초단기실황 조회서비스 (Ultra Short-term Nowcast)",
+    "base_url": "http://apis.data.go.kr/1360000/VilageFcstInfoService_2.0",
+    "default_operation": "getUltraSrtNcst",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "dataType",
+    "description": "KMA ultra short-term observed weather conditions",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "air_quality",
+    "name": "대기오염정보 조회서비스 (Air Quality)",
+    "base_url": "http://apis.data.go.kr/B552584/ArpltnInforInqireSvc",
+    "default_operation": "getCtprvnRltmMesureDnsty",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "returnType",
+    "description": "AirKorea real-time particulate matter and atmospheric pollution",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "bus_arrival",
+    "name": "경기도 버스도착정보 조회서비스 (Bus Arrival)",
+    "base_url": "http://apis.data.go.kr/6410000/busarrivalservice",
+    "default_operation": "getBusArrivalList",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "_type",
+    "description": "Gyeonggi-do real-time bus arrival information",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "hospital_info",
+    "name": "병원정보서비스 (Hospital Information)",
+    "base_url": "http://apis.data.go.kr/B551182/hospInfoServicev2",
+    "default_operation": "getHospBasisList",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "_type",
+    "description": "Hospital basic information and medical institution lookup",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "apt_trade",
+    "name": "아파트매매 실거래자료 (Apartment Trade)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcAptTradeDev",
+    "default_operation": "getRTMSDataSvcAptTradeDev",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT apartment trade real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "apt_rent",
+    "name": "아파트 전월세 실거래자료 (Apartment Rent)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcAptRent",
+    "default_operation": "getRTMSDataSvcAptRent",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT apartment rent real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "offi_trade",
+    "name": "오피스텔 매매 실거래자료 (Officetel Trade)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcOffiTrade",
+    "default_operation": "getRTMSDataSvcOffiTrade",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT officetel trade real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "offi_rent",
+    "name": "오피스텔 전월세 실거래자료 (Officetel Rent)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcOffiRent",
+    "default_operation": "getRTMSDataSvcOffiRent",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT officetel rent real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "rh_trade",
+    "name": "연립다세대 매매 실거래자료 (Row House Trade)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcRHTrade",
+    "default_operation": "getRTMSDataSvcRHTrade",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT row house trade real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "rh_rent",
+    "name": "연립다세대 전월세 실거래자료 (Row House Rent)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcRHRent",
+    "default_operation": "getRTMSDataSvcRHRent",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT row house rent real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "sh_trade",
+    "name": "단독/다가구 매매 실거래자료 (Single House Trade)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcSHTrade",
+    "default_operation": "getRTMSDataSvcSHTrade",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT single house trade real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  },
+  {
+    "dataset_key": "sh_rent",
+    "name": "단독/다가구 전월세 실거래자료 (Single House Rent)",
+    "base_url": "http://apis.data.go.kr/1613000/RTMSDataSvcSHRent",
+    "default_operation": "getRTMSDataSvcSHRent",
+    "representation": "api_json",
+    "service_key_param": "serviceKey",
+    "format_param": "resultType",
+    "description": "MOLIT single house rent real transaction data",
+    "operations": ["list", "raw"],
+    "query_support": {
+      "pagination": "offset",
+      "max_page_size": 1000
+    }
+  }
+]

{kpubdata-0.2.1 → kpubdata-0.2.3}/src/kpubdata/providers/lofin/adapter.py

@@ -15,12 +15,29 @@ from kpubdata.exceptions import (
 )
 from kpubdata.providers._common import build_schema_from_metadata, coerce_int, load_catalogue
 from kpubdata.transport.decode import decode_json
-from kpubdata.transport.http import HttpTransport, TransportConfig
+from kpubdata.transport.http import HttpTransport, TransportConfig, TransportRequirements
 
 logger = logging.getLogger("kpubdata.provider.lofin")
 
 
+def _lofin_ssl_context() -> ssl.SSLContext:
+    """Create an SSL context compatible with the LOFIN server.
+
+    The LOFIN server (www.lofin365.go.kr) uses TLSv1.2 with AES256-SHA256,
+    which requires a relaxed security level in OpenSSL 3.x.
+    """
+    ctx = ssl.create_default_context()
+    ctx.check_hostname = False
+    ctx.verify_mode = ssl.CERT_NONE
+    ctx.set_ciphers("DEFAULT:@SECLEVEL=1")
+    return ctx
+
+
 class LofinAdapter:
+    transport_requirements: TransportRequirements = TransportRequirements(
+        ssl_context_factory=_lofin_ssl_context,
+    )
+
     def __init__(
         self,
         *,
@@ -32,10 +49,7 @@ class LofinAdapter:
         if transport is not None:
             self._transport: HttpTransport = transport
         else:
-            ssl_ctx = ssl.create_default_context()
-            ssl_ctx.check_hostname = False
-            ssl_ctx.verify_mode = ssl.CERT_NONE
-            ssl_ctx.set_ciphers("DEFAULT:@SECLEVEL=1")
+            ssl_ctx = _lofin_ssl_context()
             transport_config = TransportConfig(
                 timeout=self._config.timeout,
                 max_retries=self._config.max_retries,

kpubdata-0.2.3/tests/fixtures/datago/success_apt_rent.json

@@ -0,0 +1,55 @@
+{
+  "response": {
+    "header": {
+      "resultCode": "00",
+      "resultMsg": "NORMAL SERVICE."
+    },
+    "body": {
+      "items": {
+        "item": [
+          {
+            "sggCd": "11680",
+            "umdNm": "역삼동",
+            "aptNm": "역삼자이",
+            "jibun": "754-1",
+            "excluUseAr": "84.97",
+            "dealYear": "2024",
+            "dealMonth": "2",
+            "dealDay": "14",
+            "deposit": "120,000",
+            "monthlyRent": "80",
+            "floor": "15",
+            "buildYear": "2016",
+            "contractTerm": "202402-202502",
+            "contractType": "갱신",
+            "useRRRight": "N",
+            "preDeposit": "115,000",
+            "preMonthlyRent": "75"
+          },
+          {
+            "sggCd": "41135",
+            "umdNm": "백현동",
+            "aptNm": "판교푸르지오그랑블",
+            "jibun": "531",
+            "excluUseAr": "59.88",
+            "dealYear": "2024",
+            "dealMonth": "3",
+            "dealDay": "8",
+            "deposit": "90,000",
+            "monthlyRent": "55",
+            "floor": "9",
+            "buildYear": "2011",
+            "contractTerm": "202403-202503",
+            "contractType": "신규",
+            "useRRRight": "N",
+            "preDeposit": "0",
+            "preMonthlyRent": "0"
+          }
+        ]
+      },
+      "numOfRows": 10,
+      "pageNo": 1,
+      "totalCount": 2
+    }
+  }
+}

kpubdata-0.2.3/tests/fixtures/datago/success_offi_rent.json

@@ -0,0 +1,57 @@
+{
+  "response": {
+    "header": {
+      "resultCode": "00",
+      "resultMsg": "NORMAL SERVICE."
+    },
+    "body": {
+      "items": {
+        "item": [
+          {
+            "sggCd": "11680",
+            "sggNm": "강남구",
+            "umdNm": "삼성동",
+            "jibun": "158-20",
+            "offiNm": "삼성 서초리버뷰",
+            "excluUseAr": "27.41",
+            "dealYear": "2024",
+            "dealMonth": "4",
+            "dealDay": "3",
+            "deposit": "30,000",
+            "monthlyRent": "120",
+            "floor": "14",
+            "buildYear": "2020",
+            "contractType": "신규",
+            "contractTerm": "202404-202504",
+            "useRRRight": "N",
+            "preDeposit": "0",
+            "preMonthlyRent": "0"
+          },
+          {
+            "sggCd": "41131",
+            "sggNm": "성남수정구",
+            "umdNm": "창곡동",
+            "jibun": "509",
+            "offiNm": "위례중앙타워",
+            "excluUseAr": "35.92",
+            "dealYear": "2024",
+            "dealMonth": "4",
+            "dealDay": "21",
+            "deposit": "20,000",
+            "monthlyRent": "95",
+            "floor": "7",
+            "buildYear": "2017",
+            "contractType": "갱신",
+            "contractTerm": "202404-202604",
+            "useRRRight": "Y",
+            "preDeposit": "18,000",
+            "preMonthlyRent": "90"
+          }
+        ]
+      },
+      "numOfRows": 10,
+      "pageNo": 1,
+      "totalCount": 2
+    }
+  }
+}

kpubdata-0.2.3/tests/fixtures/datago/success_offi_trade.json

@@ -0,0 +1,57 @@
+{
+  "response": {
+    "header": {
+      "resultCode": "00",
+      "resultMsg": "NORMAL SERVICE."
+    },
+    "body": {
+      "items": {
+        "item": [
+          {
+            "sggCd": "11680",
+            "sggNm": "강남구",
+            "umdNm": "논현동",
+            "jibun": "211-21",
+            "offiNm": "논현 아이파크",
+            "excluUseAr": "29.76",
+            "dealYear": "2024",
+            "dealMonth": "1",
+            "dealDay": "19",
+            "dealAmount": "31,500",
+            "floor": "11",
+            "buildYear": "2018",
+            "cdealType": "-",
+            "cdealDay": "",
+            "dealingGbn": "중개거래",
+            "estateAgentSggNm": "서울 강남구",
+            "slerGbn": "개인",
+            "buyerGbn": "개인"
+          },
+          {
+            "sggCd": "26110",
+            "sggNm": "해운대구",
+            "umdNm": "우동",
+            "jibun": "1505",
+            "offiNm": "센텀스카이비즈",
+            "excluUseAr": "42.13",
+            "dealYear": "2024",
+            "dealMonth": "2",
+            "dealDay": "27",
+            "dealAmount": "22,800",
+            "floor": "18",
+            "buildYear": "2015",
+            "cdealType": "-",
+            "cdealDay": "",
+            "dealingGbn": "직거래",
+            "estateAgentSggNm": "",
+            "slerGbn": "법인",
+            "buyerGbn": "개인"
+          }
+        ]
+      },
+      "numOfRows": 10,
+      "pageNo": 1,
+      "totalCount": 2
+    }
+  }
+}