Cargas directas de PDF
Cargas de almacenamiento presignadas seguras, sumas de comprobación SHA-256, finalización de carga y vencimiento.
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 -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.
