Logotipo de PDFHQ

Documentos

DocumentaciónPrimeros pasos

Verificación previa a la subida

Comprueba la elegibilidad de la operación PDF, los metadatos firmados, los límites de lote y las estimaciones de créditos HQ antes de sellar o subir archivos.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Validar operaciones PDF sin subir archivos#

POST /v1/preflight valida una operación PDF propuesta, sus metadatos, ajustes, restricciones del plan y una estimación orientativa de créditos HQ sin asignar almacenamiento, crear una tarea ni cobrar créditos. Indica format, size_bytes y page_count de cada archivo. Se autentica mediante una sesión de cuenta o una clave API con permisos sobre tareas; las solicitudes anónimas limitadas no pueden consultar los saldos.

cURL
curl -X POST 'https://api.pdfhq.io/v1/preflight'   -H 'Content-Type: application/json'   -H 'x-api-key: YOUR_API_KEY'   -d '{"operation":"merge","inputs":[{"format":"pdf","size_bytes":51200,"page_count":2},{"format":"pdf","size_bytes":40960,"page_count":3}],"file_count":2,"settings":{}}'

Examina supported, eligible, can_proceed, blockers, quote y next_actions. Solo una oferta verificada por HQTools puede resolver un bloqueo que admita compra. Una solicitud técnicamente no compatible no debe mostrar un muro de pago.

Ejecución y seguridad#

Los límites de solicitudes y la validación estricta protegen el punto de acceso anónimo. Una verificación previa correcta no reserva créditos, no fija un precio ni demuestra el contenido de los PDF subidos. Firma y sube directamente al almacenamiento, crea la tarea y deja que el servidor vuelva a validar los documentos reales, los derechos, las cuotas y los créditos HQ durante la ejecución.

Los SDK de referencia incluyen preflight(request) en diez lenguajes y la especificación OpenAPI activa /openapi.json describe los contratos públicos. Gestiona las respuestas HTTP 422 (validación), 429 (límite de solicitudes) y 503 (indisponibilidad).

Logotipo de PDFHQ

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

© 2026 PDFHQ. Todos los derechos reservados.