예외

TypeSafe API 오류, 속도 제한, 연결 실패, 타임아웃을 처리합니다.

기본 예외

typesafe_sdk.TypeSafeError

상속: Exception

SDK 실패의 기본 예외입니다.

HTTP 오류

typesafe_sdk.TypeSafeAPIError

상속: TypeSafeError

본문과 요청 메타데이터를 포함한 실패한 HTTP 응답입니다.

status

instance-attribute

status = status

HTTP 응답 상태 코드입니다.

body

instance-attribute

body = body

서버의 JSON 오류 본문, 일반 응답 텍스트, 또는 빈 본문이면 None입니다.

headers

instance-attribute

headers = headers

HTTP 응답 헤더입니다.

endpoint

instance-attribute

endpoint = endpoint

가능한 경우 자격 증명, 쿼리 매개변수, 프래그먼트를 제외한 요청 메서드와 URL입니다.

request_id

property

request_id: str | None

응답 헤더 x-typesafe-request-id, 없으면 None입니다.

typesafe_sdk.TypeSafeBadRequestError

상속: TypeSafeAPIError

요청이 유효하지 않았습니다(400).

typesafe_sdk.TypeSafeAuthenticationError

상속: TypeSafeAPIError

인증에 실패했습니다(401).

typesafe_sdk.TypeSafePermissionDeniedError

상속: TypeSafeAPIError

접근이 거부되었습니다(403).

typesafe_sdk.TypeSafeNotFoundError

상속: TypeSafeAPIError

리소스를 찾을 수 없습니다(404).

typesafe_sdk.TypeSafeUnprocessableEntityError

상속: TypeSafeAPIError

요청이 서버 검증에 실패했습니다(422).

typesafe_sdk.TypeSafeRateLimitError

상속: TypeSafeAPIError

속도 제한을 초과했습니다(429).

retry_after_ms

instance-attribute

retry_after_ms = parse_retry_after(headers)

서버가 요청한 대기 시간(밀리초), 사용할 수 없으면 None입니다.

typesafe_sdk.TypeSafeInternalServerError

상속: TypeSafeAPIError

서버가 요청을 처리하지 못했습니다(5xx).

연결 오류

typesafe_sdk.TypeSafeAPIConnectionError

상속: TypeSafeError, ConnectionError

HTTP 응답 없이 요청이 실패했습니다.

typesafe_sdk.TypeSafeAPITimeoutError

상속: TypeSafeAPIConnectionError, TimeoutError

요청이 구성된 타임아웃을 초과했습니다.

timeout

instance-attribute

timeout = timeout

요청에 사용된 타임아웃 설정으로, 초 단위이거나 httpx2.Timeout입니다.

응답 검증

typesafe_sdk.TypeSafeAPIResponseValidationError

상속: TypeSafeAPIError

본문에 필요한 데이터가 없거나 구조적으로 유효하지 않은 성공 HTTP 응답입니다.

field_path

instance-attribute

field_path = field_path

문제가 있는 필드의 점으로 구분된 경로로, 예를 들어 answers.tone.confidence입니다.

args

instance-attribute

args = (
    status,
    body,
    headers,
    field_path,
    endpoint,
)