Poner un logo en un PDF
Cada PDF que sale de su sistema es una oportunidad de recordarle a quien lo abre quién lo hizo. Este endpoint estampa su logo en cada página de un PDF automáticamente — para dar identidad a facturas, marcar borradores o dejar constancia de autoría en informes exportados.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué un logo en la página importa más de lo que parece
Un PDF sin identidad visual se lee como genérico sin importar qué tan bueno sea el contenido — una cotización, un informe o un contrato que podría venir de cualquiera. Los equipos de ventas, las agencias y las plataformas que generan documentos en nombre de sus usuarios tarde o temprano chocan con lo mismo: el resultado necesita verse como si viniera de un lugar específico. Abrir manualmente cada PDF en un editor para colocar un logo no sobrevive al volumen real, y ese es exactamente el vacío que cierra este endpoint.
Qué le hace realmente la marca de agua al archivo
La imagen que proporciona se superpone en cada página del PDF de destino en la posición, escala y opacidad que usted defina — una marca discreta en una esquina para identidad sutil, un sello semitransparente centrado tipo BORRADOR, o un fondo de página completa para un tratamiento más contundente. Se compone dentro del contenido mismo de la página, no como una capa separada que un visor pueda ocultar, así que sobrevive a la impresión, el aplanado y la mayoría de conversiones posteriores.
Cómo funciona la solicitud
Envía por POST el PDF de destino y la imagen del logo a /pdf/watermark-image, junto con sus ajustes de posicionamiento. Como toda tarea aquí, es asíncrona — recibe un task_id de inmediato y el PDF ya con marca llega a su webhook firmado, o queda disponible en un enlace firmado válido por 24 horas si prefiere recuperarlo usted mismo.
Dónde encaja en un sistema real
Este paso se ubica naturalmente al final de un flujo de generación de documentos: después de armar el PDF de una factura, propuesta o informe, esta llamada le da identidad antes de enviarlo por correo o almacenarlo. Las plataformas que permiten a sus usuarios exportar PDF en su nombre suelen pasar cada exportación por este endpoint automáticamente, para que la marca nunca dependa de que alguien se acuerde de agregarla.
La economía de estampar a escala
Es una tarifa plana de $0.002 por solicitud, independiente del número de páginas, lo que convierte marcar miles de documentos en una partida predecible y no variable. Una tarea fallida tras los reintentos automáticos nunca se cobra, y ni el logo ni el PDF de origen se conservan más allá del período de retención documentado.
Qué puede hacer con ella
Dar identidad a facturas autogeneradas
Un sistema de facturación produce PDF de facturas de forma programática; este endpoint estampa el logo de la empresa en cada una antes de que llegue al correo del cliente.
Marcar documentos como borrador
Los equipos legales y financieros necesitan que los revisores sepan que un PDF no es la versión final; un logo o sello semitransparente en cada página lo deja claro.
Marca blanca para informes de clientes
Una agencia genera informes en nombre de sus propios clientes y aplica automáticamente el logo de cada cliente antes de la entrega.
Proteger exportaciones compartidas
Una plataforma permite a sus usuarios descargar PDF de sus datos; marcarlos con el sello de la plataforma desalienta la redistribución sin crédito.
Preguntas frecuentes
¿Cómo agrego un logo a un PDF vía API?
Envía por POST su PDF y la imagen del logo a /pdf/watermark-image con sus ajustes de posición; el archivo con marca regresa por webhook o enlace firmado.
¿Puedo controlar dónde aparece el logo?
Sí — define posición, escala y opacidad, desde una marca pequeña en una esquina hasta un sello centrado a página completa.
¿La marca de agua se aplica en todas las páginas?
Por defecto se aplica en todas las páginas, así la identidad visual es consistente sin importar la extensión del documento.
¿Qué formatos de imagen sirven como marca de agua?
Los formatos rasterizados comunes con soporte de transparencia funcionan mejor, porque la transparencia permite que el logo se integre a la página en vez de verse como un bloque opaco.
¿Este endpoint es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿La marca de agua se mantiene si alguien imprime el PDF?
Sí, al estar compuesta dentro del contenido de la página y no como una capa removible, se imprime y se aplana junto con el resto de la página.
¿Puedo marcar muchos PDF a la vez?
Envía una tarea por PDF; cada una se tarifica y procesa de forma independiente, así los lotes escalan de manera lineal y predecible.
¿Qué pasa si la tarea de marca de agua falla?
Reintenta automáticamente hasta tres veces, y si aun así falla recibe un error claro sin costo por el intento.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/pdf/watermark-image \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"pdf":"https://ejemplo.com/documento.pdf"}'const res = await fetch("https://api.kit.forhosting.com/pdf/watermark-image", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"pdf": "https://ejemplo.com/documento.pdf"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/pdf/watermark-image",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"pdf": "https://ejemplo.com/documento.pdf"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/pdf/watermark-image", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"pdf":"https://ejemplo.com/documento.pdf"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"pdf":"https://ejemplo.com/documento.pdf"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/pdf/watermark-image", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"pdf": "https://ejemplo.com/documento.pdf"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "pdf.watermark_image",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_mb | 25 |
max_pages | 200 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
413 | input_too_large | El archivo supera el límite de tamaño. |