Excepciones

Gestiona los errores de la API de TypeSafe, los límites de velocidad, los fallos de conexión y los tiempos de espera.

Excepción base

typesafe_sdk.TypeSafeError

Bases: Exception

Excepción base para los fallos del SDK.

Errores HTTP

typesafe_sdk.TypeSafeAPIError

Bases: TypeSafeError

Una respuesta HTTP fallida con su cuerpo y los metadatos de la solicitud.

status

instance-attribute

status = status

Código de estado de la respuesta HTTP.

body

instance-attribute

body = body

El cuerpo de error JSON del servidor, el texto sin formato de la respuesta o None si el cuerpo está vacío.

headers

instance-attribute

headers = headers

Cabeceras de la respuesta HTTP.

endpoint

instance-attribute

endpoint = endpoint

El método y la URL de la solicitud, sin credenciales, parámetros de consulta ni fragmento, cuando están disponibles.

request_id

property

request_id: str | None

La cabecera de respuesta x-typesafe-request-id, o None si no está presente.

typesafe_sdk.TypeSafeBadRequestError

Bases: TypeSafeAPIError

La solicitud no era válida (400).

typesafe_sdk.TypeSafeAuthenticationError

Bases: TypeSafeAPIError

La autenticación falló (401).

typesafe_sdk.TypeSafePermissionDeniedError

Bases: TypeSafeAPIError

Se denegó el acceso (403).

typesafe_sdk.TypeSafeNotFoundError

Bases: TypeSafeAPIError

No se encontró el recurso (404).

typesafe_sdk.TypeSafeUnprocessableEntityError

Bases: TypeSafeAPIError

La solicitud no superó la validación del servidor (422).

typesafe_sdk.TypeSafeRateLimitError

Bases: TypeSafeAPIError

Se superó el límite de velocidad (429).

retry_after_ms

instance-attribute

retry_after_ms = parse_retry_after(headers)

La espera solicitada por el servidor, en milisegundos, o None si no está disponible.

typesafe_sdk.TypeSafeInternalServerError

Bases: TypeSafeAPIError

El servidor no pudo procesar la solicitud (5xx).

Errores de conexión

typesafe_sdk.TypeSafeAPIConnectionError

Bases: TypeSafeError, ConnectionError

Una solicitud falló sin una respuesta HTTP.

typesafe_sdk.TypeSafeAPITimeoutError

Bases: TypeSafeAPIConnectionError, TimeoutError

Una solicitud superó su tiempo de espera configurado.

timeout

instance-attribute

timeout = timeout

El valor de tiempo de espera usado para la solicitud, en segundos o como httpx2.Timeout.

Validación de respuestas

typesafe_sdk.TypeSafeAPIResponseValidationError

Bases: TypeSafeAPIError

Una respuesta HTTP correcta cuyo cuerpo carecía de datos obligatorios o los tenía con una estructura no válida.

field_path

instance-attribute

field_path = field_path

Ruta con puntos hasta el campo problemático, como answers.tone.confidence.

args

instance-attribute

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