Reparar PDF

Reparar PDF es una API que arregla un PDF que no abre o que da el aviso de "archivo dañado": reconstruye su estructura interna (el índice que dice dónde está cada página) y te devuelve un PDF limpio con todo lo que se pudo salvar.

Cómo funciona

Le mandas el PDF y te devuelve otro con la estructura reconstruida. Si el archivo no tenía ningún problema, te devuelve una copia equivalente. En la respuesta te dice si encontró algo que arreglar (repaired) y cuántas páginas salen (pages).

Aviso honesto: repara la estructura del PDF, no el contenido. Si el archivo se cortó a mitad de una descarga, las páginas cuyos datos no llegaron a guardarse no se pueden inventar: recuperas las que sí están, y pages te dice cuántas son. Si solo falta el final del archivo (lo más típico cuando una descarga se corta por poco), normalmente sale casi todo. Si el PDF tiene contraseña, quítasela antes con Quitar contraseña. Si no se puede salvar nada, te lo decimos y no se cobra el crédito.

Lo único que necesitas

Tu API key. La creas en tu panel con "+ Crear llave".
En tu plataforma de automatización, un paso de tipo "HTTP Request" (n8n, Make, Zapier, Pipedream…).

Cómo usarlo en n8n

Method: POST · URL: https://api.cofferdock.com/pdf-repair
Send Headers: x-api-key = tu llave
Send Body: archivo binario (en n8n: "n8n Binary File")
En Options → Response → Response Format: elige File

Opciones

No tiene opciones: le mandas el PDF y listo. Cuesta 1 crédito por llamada, y si no se puede salvar nada, no se cobra.

Resumen de la API

Endpoint: POST https://api.cofferdock.com/pdf-repair
Auth: cabecera x-api-key: TU_LLAVE.
Entrada: PDF a pelo, o JSON { "file": "<base64>" }. El marcador %PDF- tiene que aparecer en el primer KB del archivo.
Motor: qpdf. Al abrir un PDF con el índice (xref) roto o ausente, lo reconstruye leyendo el archivo objeto a objeto y escribe uno nuevo.
Errores: 400 si no parece un PDF o tiene contraseña; 422 si no se puede salvar nada (se devuelve el crédito); 503 con Retry-After si el servidor está ocupado.
Límites: 20 peticiones/min por IP. PDF de hasta 20 MB (50 MB en Business y Scale). 1 llamada = 1 crédito.

Opciones

Opción	Por defecto	Descripción
`output`	`json`	`json` (el PDF en base64), `pdf` o `binary` (el PDF tal cual) o `url` (un enlace de descarga de 15 minutos). Con el PDF a pelo, por defecto devuelve el PDF.

Ejemplo

curl -X POST "https://api.cofferdock.com/pdf-repair" \
  -H "x-api-key: TU_LLAVE" -H "Content-Type: application/pdf" \
  --data-binary @danado.pdf \
  --output reparado.pdf

Respuesta

{ "success": true, "pdf": "JVBERi0xLjQK...", "mime_type": "application/pdf",
    "meta": { "repaired": true, "pages": 19,
    "warnings": ["input.pdf: file is damaged", "input.pdf: can't find startxref"],
    "warnings_total": 4, "original_size_bytes": 2412345, "size_bytes": 2301120,
    "used": 12, "remaining": 488 } }

Lo que recibes

meta.repaired es true si había algo roto y se rodeó, y false si el PDF estaba bien. meta.pages son las páginas que tiene el resultado: compáralas con las que esperabas. meta.warnings son los avisos técnicos de qpdf (en inglés, hasta 10), por si quieres guardarlos o ver qué estaba roto. Con el PDF a pelo, el PDF llega directo y estos datos van en las cabeceras X-Pdf-Pages y X-Pdf-Repaired.