Logotipo de PDFHQ

Documentos

DocumentaciónOperaciones PDF

API de optimización de PDF

Optimización PDF estructural sin pérdidas utilizando el ciclo de vida de tareas seguro, con sanitización de metadatos opcional.

Claves de API del lado del servidor Cargas de almacenamiento firmadas

Semántica de punto final y tarea#

Código de operación: optimize

Inicia esta operación con POST /v1/tasks y el código de herramienta que se muestra arriba. Cargue y adjunte archivos PDF de origen (o utilice puntos finales de carga con alcance de tarea), luego llame POST /v1/tasks/{task_id}/process con configuración de operación.

Reducir la estructura de objetos PDF redundante antes del archivado y entrega sin reemplazar texto seleccionable.

Entradas: Exactamente un PDF sellado, un techo de operación de 100 MiB y 500 páginas; los límites de carga/trabajo y plan configurados pueden ser menores.

Configuración y parámetros adicionales#

ConfiguraciónTipoComportamiento
profilebalanced | losslessLimpieza equilibrada de flujos de contenido; sin pérdidas retiene la estructura de flujo original. Predeterminado: balanced.
strip_metadatabooleanTambién elimina metadatos, JavaScript, texto oculto y archivos adjuntos. Predeterminado: false.

La API valida las opciones. Los parámetros desconocidos y los valores no admitidos devuelven un error en lugar de ignorarse.

Secuencia de solicitud en funcionamiento#

Programming language: cURL

Elige un idioma · desplázate horizontalmente para los 10 idiomas de SDK

API example · cURL
# Server-side API calls. Save the returned task_id.
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"tool":"optimize"}'

# Upload and verify 1 PDF(s), then obtain and approve a credit quote:
curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID/quote' -H 'x-api-key: YOUR_API_KEY'

# ONLY after explicit customer approval:
test "$PDFHQ_APPROVE_QUOTE" = yes || { echo "Approval required" >&2; exit 1; }
curl -fsS -X POST 'https://api.pdfhq.io/v1/tasks/TASK_ID/process' \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"profile":"balanced","strip_metadata":false}}'

curl -fsS 'https://api.pdfhq.io/v1/tasks/TASK_ID' -H 'x-api-key: YOUR_API_KEY'

After starting a task, upload and verify PDFs, review the credit quote, and get explicit approval before processing. API keys belong on your server, never on signed storage uploads.

All 10 SDKs ↓Tutorial completo de Python ↓ Tutorial completo de Bash/cURL ↓ Todos los endpoints → Cargas directas → Manejo de errores →

Los paquetes descargables generados cubren solo el flujo de tareas. Los SDK de servicio completo requieren una especificación OpenAPI de tiempo de ejecución verificada; los SDK de tareas de Python, JavaScript y TypeScript transmiten cargas de archivos; los otros idiomas requieren cargas multiparte firmadas implementadas por el llamador.

El ID de tarea devuelto se utiliza tanto para sondeo de estado como para recuperación. Después de que la tarea se complete correctamente, solicite una URL de salida firmada en lugar de incrustar un secreto de descarga.

Resultado y detalles importantes#

Nuevo PDF con referencias de objeto compactadas y flujos deflacionados; recuento de páginas preservado.

Esta es optimización estructural, no compresión de imagen con pérdida. La salida puede ser más grande. Los formularios o firmas deben verificarse después de reescribir; las firmas criptográficas no se conservarán.

Errores, reintentos y facturación
Logotipo de PDFHQ

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

© 2026 PDFHQ. Todos los derechos reservados.