Use case
Úsalo para dar referencias estables a paquetes unidos, auditorías y revisiones. La herramienta web sirve para revisión manual; la API, para automatización estable del lado servidor.
PDF Tools API
API para numerar páginas PDF
Integra añadir números de página en tu backend, tareas por lotes o producto sin mantener una infraestructura propia de PDF.
Credits
1 Credit / call
1 Credit per successful API request. Failed processing attempts are refunded automatically.
Pricing
1,000 Credits = $1
Every signed-in user receives 100 free API Credits each month.
Endpoint
/api/external/pdf-tools/page-numbersUse your API Key in the x-api-key header.
cURL example
curl -X POST https://itextmaster.com/api/external/pdf-tools/page-numbers \
-H 'x-api-key: YOUR_API_KEY' \
-F 'file=@input.pdf;type=application/pdf' \
-F 'options={"position":"bottom-center","startNumber":1}' \
--output numbered.pdfMultipart example
curl -X POST https://itextmaster.com/api/external/pdf-tools/page-numbers \
-H 'x-api-key: YOUR_API_KEY' \
-F 'file=@input.pdf;type=application/pdf' \
-F 'options={"position":"bottom-center","startNumber":1}' \
--output numbered.pdfJSON base64 example
curl -X POST https://itextmaster.com/api/external/pdf-tools/page-numbers \
-H 'Content-Type: application/json' \
-H 'x-api-key: YOUR_API_KEY' \
-d '{
"file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
"options": {"position":"bottom-center","startNumber":1}
}' \
--output numbered.pdfNode.js example
import { writeFile } from 'node:fs/promises';
const response = await fetch('https://itextmaster.com/api/external/pdf-tools/page-numbers', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ITEXTMASTER_API_KEY
},
body: JSON.stringify({
file: { name: 'input.pdf', dataBase64: 'JVBERi0xLjcK...' },
options: {"position":"bottom-center","startNumber":1}
})
});
if (!response.ok) {
throw new Error(await response.text());
}
await writeFile('numbered.pdf', Buffer.from(await response.arrayBuffer()));Python example
import os
import requests
response = requests.post(
'https://itextmaster.com/api/external/pdf-tools/page-numbers',
headers={
'Content-Type': 'application/json',
'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
},
json={
'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
'options': {'position': 'bottom-center', 'startNumber': 1}
},
)
response.raise_for_status()
with open('numbered.pdf', 'wb') as f:
f.write(response.content)Error codes
401
invalid_api_keyFalta x-api-key, no es válida o fue rotada.
402
insufficient_creditsLa cuenta no tiene API Credits suficientes.
422
pdf_tool_processing_failedNo se pudo procesar el archivo, las opciones o la estructura del PDF. Los Credits se devuelven automáticamente si falla.
Limits
- Necesita un PDF válido o datos de entrada correctos.
- Llama a la API desde el servidor para no exponer tu API Key.
- Prueba archivos representativos antes de procesar lotes grandes.
Response headers
numbered.pdf con cabeceras de Credits consumidos y saldo restante.
Content-Type- Tipo MIME del archivo generado, normalmente application/pdf o application/zip.
Content-Disposition- Nombre de descarga del archivo generado.
X-Credits-Charged- Credits cobrados por la solicitud correcta.
X-Credit-Balance- Saldo de API Credits después de la solicitud.
FAQ
¿Cuánto cuesta API para numerar páginas PDF?
Cada solicitud correcta usa API Credits; si el procesamiento falla, se devuelven automáticamente. Cada usuario con sesión recibe 100 free API Credits al mes, y 1,000 Credits = $1.
¿Las herramientas web usan API Credits?
No. Las herramientas que procesan en el navegador no consumen API Credits. Solo cuentan las solicitudes con API Key.
¿Puedo llamar la API desde el navegador?
No es recomendable. Guarda la API Key en tu backend, cola o automatización del servidor.
Start with 100 free API Credits
Create an API Key, test API para numerar páginas PDF, and buy more Credits only when automation volume grows.