Logotipo de PDFHQ

Documentos

DocumentaciónPrimeros pasos

Cargas directas de PDF

Cargas de almacenamiento presignadas seguras, sumas de comprobación SHA-256, finalización de carga y vencimiento.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Biblioteca de documentos#

Después de sellar una carga, registre su upload_id y título con POST /v1/workspace/documents. La biblioteca almacena una referencia con alcance de cuenta y clave API, sin copiar el archivo ni extender su vencimiento original.

Lista, renombra y elimina referencias en /v1/workspace/documents. Los puntos finales de vista previa y actividad verifican nuevamente la propiedad y caducidad. PUT / {document_id}/retention acepta una marca de tiempo retained_until que solo puede acortar la disponibilidad. Eliminar una referencia deja la carga original bajo su política de retención existente.

POST /{document_id}/handoff/task adjunta la fuente a una tarea; /handoff/ai requiere la cita normal, el consentimiento explícito de la IA externa y la clave de idempotencia; /handoff/signing crea un borrador para revisarlo y enviarlo por separado. OAuth requiere files.read o files.write para operaciones de biblioteca, jobs.write para transferencia de tareas, ai.write para transferencia de IA y firmas.write para transferencia de firmas.

Admisión de archivos#

Solicitar una carga prefirmada usando POST /v1/documents/uploads con nombre de archivo, content_type=application/pdf, size_bytes y el SHA-256 en minúsculas de los bytes de origen exactos. La respuesta contiene una URL POST de S3 y campos de formulario multiparte firmados.

Envía todos los campos devueltos sin modificar y el archivo a la URL de S3. Luego llama a POST /v1/documents/uploads/{upload_id}/complete para verificar el tamaño y los metadatos y sellar el objeto. Solo las cargas listas pueden adjuntarse a tareas. Prefiere POST /v1/tasks/{task_id}/uploads y el enlace de finalización devuelto para adjuntar automáticamente el archivo.

cURL
curl -X POST https://api.pdfhq.io/v1/documents/uploads \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"filename":"report.pdf","content_type":"application/pdf","size_bytes":12345,"sha256":"ACTUAL_64_CHAR_DIGEST"}'

Privacidad y límites#

La carga de una tarea se puede adjuntar a una sola tarea. Los tickets de carga caducan; El tamaño, la firma del PDF y el resumen deben coincidir. No conserve las URL firmadas ni registre contenido de archivos confidenciales. Los clientes pueden eliminar las cargas no utilizadas antes de enviarlas a un trabajo.

Logotipo de PDFHQ

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

© 2026 PDFHQ. Todos los derechos reservados.