콘텐츠로 이동

예외 처리

ecos-reader가 발생시키는 예외 및 경고 클래스의 자동 생성 API 레퍼런스입니다.

EcosError

Bases: Exception

ecos-reader 기본 예외

EcosAPIError

Bases: EcosError

ECOS API 호출 에러

Attributes:

Name Type Description
code str

ECOS API 에러 코드

message str

에러 메시지

EcosConfigError

Bases: EcosError

설정 관련 에러 (API Key 등)

EcosNetworkError

Bases: EcosError

네트워크 연결 에러

EcosRateLimitError

Bases: EcosError

Rate Limit 초과

EcosServerError

Bases: EcosAPIError

ECOS 서버측 오류 (5xx 성격)

서버 오류·DB Connection·SQL 오류 등. 일시적 오류(서버/DB)는 재시도 대상일 수 있습니다 (ECOS_ERROR_CODES의 retryable 플래그 참조).

EcosValidationError

Bases: EcosAPIError

클라이언트 책임 요청 오류 (4xx 성격)

필수값 누락·형식/타입 오류 등 요청 자체가 잘못된 경우. 동일 요청을 재시도해도 동일하게 실패하므로 재시도 대상이 아닙니다.