Exceptions

Gère les erreurs de l’API TypeSafe, les limites de débit, les échecs de connexion et les délais d’expiration.

Exception de base

typesafe_sdk.TypeSafeError

Bases: Exception

Exception de base pour les échecs du SDK.

Erreurs HTTP

typesafe_sdk.TypeSafeAPIError

Bases: TypeSafeError

Une réponse HTTP infructueuse, avec son corps et les métadonnées de la requête.

status

instance-attribute

status = status

Code de statut de la réponse HTTP.

body

instance-attribute

body = body

Le corps d’erreur JSON du serveur, le texte brut de la réponse, ou None pour un corps vide.

headers

instance-attribute

headers = headers

En-têtes de la réponse HTTP.

endpoint

instance-attribute

endpoint = endpoint

La méthode et l’URL de la requête, sans identifiants, paramètres de requête ni fragment, lorsqu’elles sont disponibles.

request_id

property

request_id: str | None

L’en-tête de réponse x-typesafe-request-id, ou None s’il est absent.

typesafe_sdk.TypeSafeBadRequestError

Bases: TypeSafeAPIError

La requête était invalide (400).

typesafe_sdk.TypeSafeAuthenticationError

Bases: TypeSafeAPIError

L’authentification a échoué (401).

typesafe_sdk.TypeSafePermissionDeniedError

Bases: TypeSafeAPIError

L’accès a été refusé (403).

typesafe_sdk.TypeSafeNotFoundError

Bases: TypeSafeAPIError

La ressource est introuvable (404).

typesafe_sdk.TypeSafeUnprocessableEntityError

Bases: TypeSafeAPIError

La requête a échoué à la validation du serveur (422).

typesafe_sdk.TypeSafeRateLimitError

Bases: TypeSafeAPIError

La limite de débit a été dépassée (429).

retry_after_ms

instance-attribute

retry_after_ms = parse_retry_after(headers)

Le délai d’attente demandé par le serveur, en millisecondes, ou None s’il est indisponible.

typesafe_sdk.TypeSafeInternalServerError

Bases: TypeSafeAPIError

Le serveur n’a pas pu traiter la requête (5xx).

Erreurs de connexion

typesafe_sdk.TypeSafeAPIConnectionError

Bases: TypeSafeError, ConnectionError

Une requête a échoué sans réponse HTTP.

typesafe_sdk.TypeSafeAPITimeoutError

Bases: TypeSafeAPIConnectionError, TimeoutError

Une requête a dépassé son délai d’expiration configuré.

timeout

instance-attribute

timeout = timeout

Le réglage de délai d’expiration utilisé pour la requête, en secondes ou sous forme d’httpx2.Timeout.

Validation des réponses

typesafe_sdk.TypeSafeAPIResponseValidationError

Bases: TypeSafeAPIError

Une réponse HTTP réussie dont le corps était absent ou contenait des données requises structurellement invalides.

field_path

instance-attribute

field_path = field_path

Chemin pointé vers le champ en cause, comme answers.tone.confidence.

args

instance-attribute

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