예외 (exceptions)¶

kiwoompy 커스텀 예외 계층을 정의하는 모듈입니다.

KiwoomError
└── KiwoomApiError
    └── KiwoomAuthError

kiwoompy.exceptions ¶

kiwoompy 커스텀 예외 계층.

KiwoomApiError(message: str, status_code: int | None = None)

HTTP 통신 오류 또는 응답 파싱 실패.

Parameters:

Name	Type	Description	Default
`message`	`str`	한글 오류 메시지.	required
`status_code`	`int \| None`	HTTP 상태 코드. 네트워크 오류 등으로 없을 경우 `None`.	`None`

Source code in src/kiwoompy/exceptions.py

def __init__(self, message: str, status_code: int | None = None) -> None:
    self.status_code = status_code
    super().__init__(message)

KiwoomAuthError(message: str, status_code: int | None = None)

인증 실패 — 잘못된 앱 키·시크릿 키, 토큰 미발급 등 인증 관련 오류.

Parameters:

Name	Type	Description	Default
`message`	`str`	한글 오류 메시지.	required
`status_code`	`int \| None`	HTTP 상태 코드 (주로 400·401·403).	`None`

Source code in src/kiwoompy/exceptions.py

def __init__(self, message: str, status_code: int | None = None) -> None:
    self.status_code = status_code
    super().__init__(message)

Bases: Exception

kiwoompy 최상위 예외. 모든 커스텀 예외의 기반 클래스.