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.

Errores y reintentos de la API de CloudPrint ​

Estructura estable ​

Trazabilidad ​

Cuándo repetir ​

Fallos de impresión ​