Resumen de la API

• Endpoint: POST https://api.cofferdock.com/pdf-watermark
• Auth: cabecera x-api-key: TU_LLAVE.
• Entrada: texto → application/pdf a pelo (con text en Query) o JSON con { file, text, ... }. Imagen → SOLO JSON, { file, image, ... } (dos binarios no caben en un cuerpo crudo).
• Salida: por defecto, con application/pdf devuelve el binario; con JSON devuelve base64 en pdf. Añade output=pdf o output=json para forzarlo.
• Rotación: aquí rotation admite cualquier ángulo (no solo múltiplos de 90) porque dibuja contenido girado, no cambia la orientación de la página como /pdf-rotate.
• Límites: PDF de entrada hasta 20 MB (50 MB en Business/Scale) en modo application/pdf, o ~4 MB reales en JSON con base64. 30 peticiones/min por IP. 1 marca de agua = 1 crédito.

Opciones

Opción	Por defecto	Descripción
text	—	Texto de la marca (máx. 200 car.). Exactamente uno de text/image.
image	—	Base64 de una imagen PNG o JPEG. Solo en modo JSON.
position	center	center, top-left, top-right, bottom-left, bottom-right.
opacity	0.3	0.05–1.
rotation	45	Grados, cualquier valor.
font_size	48	8–200. Solo aplica a text.
color	#808080	Hex. Solo aplica a text.
scale	0.3	0.05–1, fracción del ancho de página. Solo aplica a image.
pages	todas	Rango 1-indexado, ej. 1-3,5.
file	—	Solo en modo JSON: el PDF en base64.
output	según modo	pdf (binario) o json (base64).

Ejemplos

curl (marca de texto, PDF a pelo):

curl -X POST "https://api.cofferdock.com/pdf-watermark?text=CONFIDENCIAL&opacity=0.25" \
  -H "x-api-key: TU_LLAVE" \
  -H "Content-Type: application/pdf" \
  --data-binary @documento.pdf \
  -o marcado.pdf

JavaScript (Node 18+, marca de logo):

const fs = require('fs');
const r = await fetch('https://api.cofferdock.com/pdf-watermark', {
  method: 'POST',
  headers: { 'x-api-key': 'TU_LLAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    file: fs.readFileSync('documento.pdf').toString('base64'),
    image: fs.readFileSync('logo.png').toString('base64'),
    position: 'bottom-right', scale: 0.15, opacity: 0.6, rotation: 0,
    output: 'binary',
  }),
});
fs.writeFileSync('marcado.pdf', Buffer.from(await r.arrayBuffer()));

Python (marca de texto):

import requests
r = requests.post(
    'https://api.cofferdock.com/pdf-watermark',
    params={'text': 'CONFIDENCIAL', 'opacity': 0.25},
    headers={'x-api-key': 'TU_LLAVE', 'Content-Type': 'application/pdf'},
    data=open('documento.pdf', 'rb').read(),
)
open('marcado.pdf', 'wb').write(r.content)

Modo JSON (respuesta en base64)

{ "file": "JVBERi0xLjQ…", "text": "BORRADOR", "position": "center" }
→ { "success": true, "pdf": "JVBERi0xLjQ…", "mime_type": "application/pdf",
    "meta": { "pages_watermarked": 4, "type": "text", "total_pages": 4, "used": 12, "remaining": 488 } }

API overview

• Endpoint: POST https://api.cofferdock.com/pdf-watermark
• Auth: header x-api-key: YOUR_KEY.
• Input: text → raw application/pdf (with text as a Query param) or JSON with { file, text, ... }. Image → JSON ONLY, { file, image, ... } (two binaries don't fit in a raw body).
• Output: by default, with application/pdf it returns the binary; with JSON it returns base64 in pdf. Add output=pdf or output=json to force it.
• Rotation: here rotation accepts any angle (not just multiples of 90) because it draws rotated content, unlike /pdf-rotate, which changes the page's own orientation.
• Limits: input PDF up to 20 MB (50 MB on Business/Scale) in application/pdf mode, or ~4 MB real in JSON with base64. 30 requests/min per IP. 1 watermark = 1 credit.

Options

Option	Default	Description
text	—	Watermark text (max 200 chars). Exactly one of text/image.
image	—	Base64 of a PNG or JPEG image. JSON mode only.
position	center	center, top-left, top-right, bottom-left, bottom-right.
opacity	0.3	0.05–1.
rotation	45	Degrees, any value.
font_size	48	8–200. Applies to text only.
color	#808080	Hex. Applies to text only.
scale	0.3	0.05–1, fraction of page width. Applies to image only.
pages	all	1-indexed range, e.g. 1-3,5.
file	—	JSON mode only: the PDF in base64.
output	per mode	pdf (binary) or json (base64).

Examples

curl (text watermark, raw PDF):

curl -X POST "https://api.cofferdock.com/pdf-watermark?text=CONFIDENTIAL&opacity=0.25" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/pdf" \
  --data-binary @document.pdf \
  -o watermarked.pdf

JavaScript (Node 18+, logo watermark):

const fs = require('fs');
const r = await fetch('https://api.cofferdock.com/pdf-watermark', {
  method: 'POST',
  headers: { 'x-api-key': 'YOUR_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    file: fs.readFileSync('document.pdf').toString('base64'),
    image: fs.readFileSync('logo.png').toString('base64'),
    position: 'bottom-right', scale: 0.15, opacity: 0.6, rotation: 0,
    output: 'binary',
  }),
});
fs.writeFileSync('watermarked.pdf', Buffer.from(await r.arrayBuffer()));

Python (text watermark):

import requests
r = requests.post(
    'https://api.cofferdock.com/pdf-watermark',
    params={'text': 'CONFIDENTIAL', 'opacity': 0.25},
    headers={'x-api-key': 'YOUR_KEY', 'Content-Type': 'application/pdf'},
    data=open('document.pdf', 'rb').read(),
)
open('watermarked.pdf', 'wb').write(r.content)

JSON mode (base64 response)

{ "file": "JVBERi0xLjQ…", "text": "DRAFT", "position": "center" }
→ { "success": true, "pdf": "JVBERi0xLjQ…", "mime_type": "application/pdf",
    "meta": { "pages_watermarked": 4, "type": "text", "total_pages": 4, "used": 12, "remaining": 488 } }