Creación idempotente de trabajos de impresión
Evita impresiones duplicadas al repetir solicitudes después de un tiempo de espera agotado o un fallo de red.
Versión de la API: v1Descargar OpenAPI v1 en JSONAbrir el explorador interactivo de la APIVer como Markdown
Por qué es necesaria
El tiempo de espera puede agotarse después de que CloudPrint acepte la solicitud. Si creas otro trabajo, el documento podría imprimirse dos veces.
Cómo definir la clave
Usa una clave estable como shipment-18451-label-v1, de hasta 128 caracteres, y conserva la misma para reintentos con el mismo contenido.
Reglas de reutilización
La misma cuenta, clave y contenido devuelven el resultado original; usar la misma clave con otro contenido devuelve 409 Conflict.
Recuperación
Tras un fallo de red, repite la solicitud con la misma clave. Cuando conozcas print_job_id, consulta el estado en lugar de crear otro trabajo.
Documentación relacionada
Crear un trabajo de impresiónEnvía un documento subido a una impresora seleccionada con idempotencia y opciones de impresión explícitas.Errores y reintentos de la API de CloudPrintGestiona estados HTTP, errores legibles por máquina, límites de solicitudes, trazabilidad y reintentos seguros.Crear y seguir trabajos de impresiónEnvía un documento a una impresora, evita duplicados y comprueba el resultado físico.