Resumen de la API

• Endpoint: POST https://api.cofferdock.com/pdf
• Auth: cabecera x-api-key: TU_LLAVE.
• Entrada: el HTML va en el cuerpo como text/html (a pelo) o como application/json en el campo html.
• Salida: por defecto, con text/html devuelve el binario del PDF (application/pdf); con JSON devuelve base64 en el campo pdf. Añade output=pdf para forzar el binario.
• Opciones: en Query Parameters o en el JSON (si coinciden, gana el JSON).
• Límites: HTML máx. 5 MB; timeout 30 s; JavaScript desactivado (solo HTML/CSS); 30 PDFs/min por IP. 1 PDF = 1 crédito.

Opciones

Ejemplos

curl (HTML a pelo, guarda el PDF en un fichero):

curl -X POST "https://api.cofferdock.com/pdf?format=A4" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: text/html" \
  --data-binary "<h1>Factura 001</h1><p>Total: 100 €</p>" \
  -o documento.pdf

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/pdf?format=A4', {
  method: 'POST',
  headers: { 'x-api-key': 'TU_LLAVE', 'Content-Type': 'text/html' },
  body: '<h1>Factura 001</h1>',
});
const buffer = Buffer.from(await r.arrayBuffer());
require('fs').writeFileSync('documento.pdf', buffer);

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/pdf',
    params={'format': 'A4'},
    headers={'x-api-key': 'TU_LLAVE', 'Content-Type': 'text/html'},
    data='<h1>Factura 001</h1>'.encode('utf-8'),
)
open('documento.pdf', 'wb').write(r.content)

Modo JSON (respuesta en base64)

Con Content-Type: application/json, el HTML va en html y las opciones en el mismo objeto. La respuesta trae el PDF en base64:

{ "html": "<h1>Factura</h1>", "format": "A4", "landscape": false }
→ { "success": true, "pdf": "JVBERi0xLjQ…", "mime_type": "application/pdf",
    "meta": { "used": 12, "remaining": 488, "size_bytes": 18421 } }

Añade "output": "pdf" al JSON para recibir el binario en lugar del base64.

API overview

• Endpoint: POST https://api.cofferdock.com/pdf
• Auth: header x-api-key: YOUR_KEY.
• Input: the HTML goes in the body as text/html (raw) or as application/json in the html field.
• Output: by default, with text/html it returns the PDF binary (application/pdf); with JSON it returns base64 in the pdf field. Add output=pdf to force the binary.
• Options: via Query Parameters or in the JSON (JSON wins if both are set).
• Limits: HTML max 5 MB; 30 s timeout; JavaScript disabled (HTML/CSS only); 30 PDFs/min per IP. 1 PDF = 1 credit.

Options

Examples

curl (raw HTML, saves the PDF to a file):

curl -X POST "https://api.cofferdock.com/pdf?format=A4" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: text/html" \
  --data-binary "<h1>Invoice 001</h1><p>Total: 100 €</p>" \
  -o document.pdf

JavaScript (Node 18+):

const r = await fetch('https://api.cofferdock.com/pdf?format=A4', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_KEY', 'Content-Type': 'text/html' },
  body: '<h1>Invoice 001</h1>',
});
const buffer = Buffer.from(await r.arrayBuffer());
require('fs').writeFileSync('document.pdf', buffer);

Python:

import requests
r = requests.post(
    'https://api.cofferdock.com/pdf',
    params={'format': 'A4'},
    headers={'x-api-key': 'YOUR_KEY', 'Content-Type': 'text/html'},
    data='<h1>Invoice 001</h1>'.encode('utf-8'),
)
open('document.pdf', 'wb').write(r.content)

JSON mode (base64 response)

With Content-Type: application/json, the HTML goes in html and the options in the same object. The response carries the PDF in base64:

{ "html": "<h1>Invoice</h1>", "format": "A4", "landscape": false }
→ { "success": true, "pdf": "JVBERi0xLjQ…", "mime_type": "application/pdf",
    "meta": { "used": 12, "remaining": 488, "size_bytes": 18421 } }

Add "output": "pdf" to the JSON to receive the binary instead of base64.