Encabezado y pie en un PDF
La API de Encabezado y Pie PDF coloca encabezados y pies de página uniformes en cada hoja de un documento — números de página, fechas, títulos, avisos de confidencialidad o una banda con logotipo — sin que tenga que abrir, reprocesar ni reajustar el archivo. Envía el PDF y una breve especificación de diseño, y le devolvemos el mismo documento con esos textos limpios y repetidos en todas sus páginas.
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.
El problema que resuelve sin ruido
Un PDF terminado casi nunca llega con los elementos recurrentes que un documento real necesita. A las facturas les falta el conteo de páginas, a los reportes no les aparece la fecha, los expedientes piden una referencia en la esquina y los contratos quieren una discreta línea Confidencial al pie. Hacerlo a mano es viable para un archivo y agotador para diez mil. Este endpoint sirve a equipos que generan documentos por código (facturación, reportería, ensamblado documental) y necesitan ese acabado de forma pareja, a escala y sin intervención humana.
Cómo funciona
Hace un POST a /pdf/header-footer con el PDF de origen y un diseño que indica qué va en cada región: izquierda, centro y derecha, en el encabezado y en el pie. El texto admite fichas como el número de página actual, el total de páginas y la fecha, así una sola especificación sirve para un memo de cinco páginas o un manual de quinientas. Como procesar archivos grandes exige trabajo real, la llamada es asíncrona: devuelve de inmediato un task_id y el PDF terminado se entrega cuando está listo, sin bloquear su petición.
De dónde vienen los encabezados y pies
Los encabezados y pies son una de las convenciones más antiguas de la tipografía: el folio y el titulillo que nombra el capítulo son anteriores a la imprenta, heredados de los copistas que numeraban las hojas a mano. El PDF adoptó el modelo visual pero no el comportamiento: describe páginas fijas, sin noción propia de un encabezado que se repite ni de un número que avanza. Ese vacío llena esta API, dibujando el contenido recurrente sobre cada página y respetando la geometría existente.
Diseñada para vivir dentro de un flujo
Es una tarea dentro de un conjunto más amplio, así que se combina con limpieza: genera o une un documento, aquí le coloca encabezados y pies, y luego lo comprime o lo protege. Los resultados se entregan por webhook firmado (la vía recomendada, porque su sistema se entera en cuanto el trabajo termina) o por un enlace firmado válido 24 horas. Los archivos existen solo mientras dura la ventana de retención y luego se eliminan; nada de lo que envía se usa jamás para entrenar ningún modelo.
Precio y fiabilidad, sin vueltas
El cobro es por página a $0.002 por solicitud, así que un documento corto cuesta una fracción de centavo y uno largo escala de forma previsible, sin tokens ni créditos. El acceso requiere saldo prepago; una solicitud sin saldo devuelve un 402 limpio, lo que mantiene el servicio rápido y libre de abuso. Si una tarea falla, la reintentamos tres veces con espera progresiva y, si aun así no se completa, le devolvemos un error claro; nunca se cobra una tarea que no tuvo éxito.
Qué puede hacer con ella
Numeración continua en un expediente unido
Un equipo legal une decenas de anexos en un solo escrito y necesita numeración corrida 'Página X de Y' más una referencia del caso en el pie, aplicada de forma automática apenas se arma el expediente.
Reportes financieros con fecha y marca
Una plataforma de reportería estampa la fecha de generación, el título del informe y un pequeño logotipo en el encabezado de cada estado de cuenta mensual antes de enviarlo al cliente, para que cada PDF se identifique solo, incluso impreso.
Avisos de confidencialidad a gran escala
Una empresa agrega una línea 'Confidencial — Uso interno' al pie de miles de documentos exportados en un solo lote, manteniendo el aviso consistente entre equipos y plantillas.
Facturas con conteo de páginas
Un sistema de facturación añade el número de factura y el total de páginas a cada PDF que sale, de modo que las facturas de varias hojas quedan sin ambigüedad y nada se pierde entre la primera y la última.
Preguntas frecuentes
¿Cómo agrego un encabezado y pie a un PDF por API?
Envíe un POST a /pdf/header-footer con su PDF de origen y un diseño que describa las posiciones izquierda, centro y derecha de cada banda. La llamada devuelve un task_id y el PDF ya estampado se entrega por webhook o enlace firmado cuando está listo.
¿Puedo agregar números de página y fechas automáticos?
Sí. El diseño acepta fichas para el número de página actual, el total de páginas y la fecha, así que una sola especificación numera bien cada hoja, tenga el documento cinco páginas o quinientas.
¿Hay un plan gratis para la API de encabezado y pie en PDF?
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.
¿Puedo poner un logotipo o una imagen en el encabezado?
Sí, las bandas de encabezado y pie pueden llevar una imagen como un logotipo junto al texto en las posiciones izquierda, centro o derecha, así marca cada página en una sola pasada.
¿Sirve para PDF grandes y lotes masivos?
Sí. Como el endpoint es asíncrono, los archivos grandes y los volúmenes altos se procesan sin bloquear su petición: envía cada documento, recibe un task_id y se le notifica a medida que cada uno termina.
¿El encabezado va a encimarse con mi contenido?
El contenido recurrente se dibuja en los márgenes de encabezado y pie que usted define, sobre la geometría existente de la página. Usted controla la ubicación, así que con márgenes sensatos el texto estampado queda limpio arriba y abajo de su contenido.
¿Cómo se entrega el PDF terminado?
Por un webhook firmado, que recomendamos porque su sistema se entera en el instante en que la tarea se completa, o por un enlace firmado válido durante 24 horas. Los archivos se eliminan tras la ventana de retención y nunca se usan para entrenar nada.
¿Qué pasa si una tarea falla? ¿Me cobran?
No. Una tarea fallida se reintenta tres veces con espera progresiva y, si aun así no se completa, recibe un error claro. Nunca se le cobra por una tarea que no tuvo éxito.
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/header-footer \
-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/header-footer", {
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/header-footer",
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/header-footer", 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/header-footer", 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.header_footer",
"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. |