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.
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 -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).
