OptimoCMSDocs
SDK

Manejo de errores

Errores tipados, estrategia de reintentos y manejo de 429 en el SDK TypeScript de OptimoCMS.

Manejo de errores

El SDK lanza errores tipados que puedes capturar y manejar.

OptimoCMSError

import { OptimoCMS, OptimoCMSError } from '@optimocms/sdk';

const cms = new OptimoCMS({ apiKey: process.env.OPTIMOCMS_API_KEY! });

try {
  await cms.pages.get('site_abc123', 'id-invalido');
} catch (error) {
  if (error instanceof OptimoCMSError) {
    console.error('Status:', error.status);       // 404
    console.error('Código:', error.code);          // "NOT_FOUND"
    console.error('Mensaje:', error.message);      // "Page not found"
    console.error('Request ID:', error.requestId); // "req_abc123"
  }
}

Reintentos automáticos

El SDK reintenta automáticamente en 429 (límite de velocidad) y 5xx (errores del servidor) con backoff exponencial.

IntentoTiempo de espera
1er reintento1 segundo
2do reintento2 segundos
3er reintento4 segundos

Siguientes pasos

On this page