Исключения

Обработка ошибок API TypeSafe, ограничений частоты, сбоев соединения и таймаутов.

Базовое исключение

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,
)