Logotipo de PDFHQ

Documentos

DocumentaciónPrimeros pasos

Idempotencia y seguridad de reintentos

Reintenta de forma segura la creación de tareas de documentos en tiempos de espera de red usando encabezados Idempotency-Key con alcance de proyecto, y distingue estos de los procesos pagados y el envío del proveedor.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Creación de tareas segura para reproducción#

POST /v1/tasks acepta un opcional Idempotency-Key (8–128 caracteres ASCII: letras, dígitos, puntos, guiones bajos, dos puntos o guiones; comienza con letra o dígito). Repetir una clave para la misma cuenta de HQTools y proyecto de API devuelve la tarea existente. Reutilizar la misma clave para una herramienta diferente devuelve 409 IDEMPOTENCY_KEY_REUSED.

Crear tarea con clave de reintento
curl -q --fail-with-body -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_SERVER_SIDE_API_KEY' \
  -H 'Idempotency-Key: job-20261025-00001' \
  -H 'Content-Type: application/json' \
  -d '{"tool":"compress"}'

El ID de tarea devuelto es estable en reintentos. Las claves están limitadas a una cuenta y proyecto de API y permanecen asociadas a la tarea hasta que se elimine el registro subyacente. Cree una nueva clave para una nueva tarea.

Diferentes reglas de reintento para diferentes recursos#

Creación de tarea: reintentar usando la misma Idempotency-Key después de una interrupción de red. Procesamiento de tareas: el ID de tarea fijo ya proporciona idempotencia de trabajo/crédito de backend para opciones idénticas; inspecciona su estado antes de intentar de nuevo. Trabajos de IA: usa una cotización aprobada por el usuario nueva y una Idempotency-Key estable compatible con el endpoint de IA. Envío de firma electrónica: una respuesta incierta del proveedor requiere reconciliación de sobre; no reenvíes ciegamente una solicitud de firma.

Las cargas S3 firmadas utilizan políticas de formulario POST de corta duración. No envíes x-api-key o Idempotency-Key a S3. Las cargas de almacenamiento y la estimación de presupuesto no cobran créditos por sí solas; el procesamiento sí.

Logotipo de PDFHQ

Herramientas PDF y análisis de documentos. Prepara, comprende y trabaja con tus documentos.

© 2026 PDFHQ. Todos los derechos reservados.