Documentación para desarrolladores

Documentación de API y subida embebida

Usa dataPdf desde tus propios sistemas con claves API para integraciones de servidor y un flujo embebido alojado para experiencias en navegador.

Camino más rápido

Presign, subida, confirmación

Autenticación

X-API-Key para llamadas de servidor

Señal de finalización

Notificación por correo por defecto

Claves API

Las claves API pertenecen a una cuenta individual de dataPdf. Están pensadas para servicios backend, tareas programadas y herramientas internas.

Genera y revoca claves desde tu cuenta sin crear un espacio de trabajo de organización separado.
Envía la clave en la cabecera X-API-Key al llamar a endpoints protegidos.
Todo el uso de páginas se factura a la cuenta propietaria de la clave, con datos de empresa opcionales para facturación.

Flujo de subida con presign y confirmación

La API refleja el flujo de subida de la aplicación para que las integraciones sigan siendo simples mientras los archivos grandes se suben directamente al almacenamiento.

Solicita una URL de subida prefirmada en /api/upload/presign.
Sube el archivo directamente a la URL de almacenamiento devuelta.
Llama a /api/upload/confirm?start=true para registrar el archivo y comenzar el procesamiento.

Widget de subida embebido

Para integraciones en navegador, usa un flujo embebido alojado en lugar de exponer claves API en código cliente.

Los usuarios se autentican con su cuenta normal de dataPdf dentro del widget.
El navegador debe recibir un token embebido de corta duración, no una clave API de larga duración.
Usa el flujo embebido cuando quieras un esfuerzo de integración bajo en un sitio web orientado al cliente.

Límites de seguridad

Mantén las claves API en el servidor y usa autenticación de sesión o token embebido en contextos de navegador.

No coloques claves API en bundles de JavaScript, URLs de iframes ni marcado público.
Rota las claves si dejan de ser necesarias o si cambia el responsable de una integración backend.
Usa datos de facturación a nivel de cuenta cuando las facturas deban mostrar información de empresa.

Secuencia mínima de integración

La mayoría de equipos solo necesitan el flujo de subida más la finalización por correo para empezar a automatizar la entrada de PDFs.

1. Create an API key in your dataPdf account settings
2. POST /api/upload/presign with X-API-Key
3. Upload the file to the returned storage URL
4. POST /api/upload/confirm?start=true
5. Wait for the completion email or fetch the result later

Idioma actual: es. Añade capturas y ejemplos de código localizados más adelante.