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.
| Intento | Tiempo de espera |
|---|---|
| 1er reintento | 1 segundo |
| 2do reintento | 2 segundos |
| 3er reintento | 4 segundos |
Siguientes pasos
- Paginación — Obtener grandes conjuntos de datos
- Autenticación — Límites de velocidad por tier