API de biblioteca de documentos e intercambios de flujo de trabajo seguro
Registra cargas de PDF selladas de tu propiedad, inspecciona metadatos privados y actividad, acorta la retención y reutiliza una carga existente en tareas, trabajos de IA cotizados o borradores de firma de sandbox.
Registrar un PDF sellado existente#
Primero carga directamente al almacenamiento privado con POST /v1/documents/uploads y POST /v1/documents/uploads/{upload_id}/complete. Una carga solo es utilizable después de que el servidor la selle y verifique. Las claves API están limitadas a la cuenta original de HQTools y al proyecto de API.
POST https://api.pdfhq.io/v1/workspace/documents
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"upload_id":"SEALED_UPLOAD_UUID","title":"Review draft"}GET /v1/workspace/documents lista solo referencias disponibles. GET /v1/workspace/documents/{document_id} verifica nuevamente la propiedad de carga original y caducidad. DELETE elimina la entrada de biblioteca, no la carga almacenada subyacente.
Vista previa privada y retención#
GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/preview-url
x-api-key: PROJECT_API_KEY
GET https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/activity
x-api-key: PROJECT_API_KEYEl endpoint preview-url devuelve una URL autorizada para almacenamiento privado con una vida útil máxima de 60 segundos, limitada por retención de fuente y biblioteca. Trata su consulta firmada como un secreto y no la registres ni almacenes en caché. El endpoint preview obsoleto está limitado a 4 MiB y verifica la fuente sellada antes de devolver bytes. Los registros de actividad GET están limitados a la misma cuenta y proyecto de API. PUT /retention solo puede acortar la disponibilidad de la biblioteca; no puede extender la retención de carga sellada.
Entrega a procesamiento de PDF, AI Studio o firma#
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/task
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"task_id":"OWNED_TASK_UUID"}
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/ai
x-api-key: PROJECT_API_KEY
Idempotency-Key: NEW_IDEMPOTENCY_KEY
Content-Type: application/json
{"operation":"pdfhq.ai.summarize","quote_id":"OWNED_HQTOOLS_QUOTE","question":"Key risks?","allow_external_ai":true}
POST https://api.pdfhq.io/v1/workspace/documents/DOCUMENT_UUID/handoff/signing
x-api-key: PROJECT_API_KEY
Content-Type: application/json
{"provider":"managed","title":"Review agreement","subject":"Please review","signers":[{"name":"Sample Signer","email":"signer@example.com","order":0}]}Transferir una tarea no genera un cargo. La transferencia a la IA exige la cotización habitual, el consentimiento para usar IA externa, el aislamiento del proyecto y la admisión mediante una única cartera de créditos HQ. La firma solo crea un borrador: enviar una solicitud de prueba requiere una confirmación explícita e independiente. Los documentos caducados o ajenos nunca se aceptan.
