--- title: "Errores y reintentos de la API de CloudPrint" description: "Gestiona estados HTTP, errores legibles por máquina, límites de solicitudes, trazabilidad y reintentos seguros." --- # Errores y reintentos de la API de CloudPrint

Gestiona estados HTTP, errores legibles por máquina, límites de solicitudes, trazabilidad y reintentos seguros.

Versión de la API: v1Descargar OpenAPI v1 en JSON Abrir el explorador interactivo de la API Ver como Markdown

## Estructura estable Los errores incluyen `error`, el campo opcional `error_code`, un `message` seguro y `details` estructurados. Basa la lógica en los campos legibles por máquina y en el estado HTTP. ## Trazabilidad Cada respuesta contiene `X-Request-Id`; guárdalo junto con tu identificador interno, `print_job_id` y la hora. ## Cuándo repetir Repite un `429` después del intervalo indicado en `Retry-After` y los errores `5xx` temporales con una espera incremental limitada. Corrige la autenticación, los permisos, los datos o el formato antes de repetir otras solicitudes. ## Fallos de impresión Una solicitud aceptada aún puede terminar en `failed`. Lee `failure_reason` y compara el formato y las opciones con las capacidades de la impresora. ## Documentación relacionada

Creación idempotente de trabajos de impresiónEvita impresiones duplicadas al repetir solicitudes después de un tiempo de espera agotado o un fallo de red. Solución de problemasDiagnostica trabajos fallidos sin provocar una segunda impresión por accidente. Explorador de CloudPrint API v1Examina de forma interactiva el contrato OpenAPI v1 completo, sus esquemas y ejemplos de código.