Manejo de errores

Las clases específicas heredan de InceptivaApiError, que conserva las propiedades compatibles status y detail.

import {
  InceptivaApiError,
  InceptivaRateLimitError,
} from "@inceptiva/sdk";

try {
  await client.responses.create({ message: "Hola" });
} catch (error) {
  if (error instanceof InceptivaRateLimitError) {
    console.error("Reintentar después de", error.retryAfter, "segundos");
  } else if (error instanceof InceptivaApiError) {
    console.error(error.status, error.detail);
  }
}

retryAfter respeta tanto segundos como una fecha HTTP y vale null cuando la cabecera no está presente o no es válida. El SDK no reintenta automáticamente.

Los errores de red y la cancelación de fetch mediante AbortSignal no se convierten en InceptivaApiError.

Todos los errores conservan status, code, message, el alias compatible detail y responseMetadata con límites de velocidad y consumo.

Códigos funcionales