PDF Tools API

API en-tête et pied PDF

Ajoutez ajouter en-têtes et pieds à votre backend, vos lots ou votre produit sans maintenir votre propre service PDF.

Create API Key Read full API docs

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/header-footer

Use your API Key in the x-api-key header.

Use case

À utiliser pour placer dates, noms de rapport et références dans des documents récurrents. L’outil web reste adapté à la revue manuelle ; l’API sert aux traitements serveur répétables.

cURL example

curl -X POST https://itextmaster.com/api/external/pdf-tools/header-footer \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}' \
  --output header-footer.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/header-footer \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}' \
  --output header-footer.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/header-footer \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}
  }' \
  --output header-footer.pdf

Node.js example

import { writeFile } from 'node:fs/promises';

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/header-footer', {
  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: {"headerText":"Quarterly Report","footerText":"Page {page} of {total}"}
})
});

if (!response.ok) {
  throw new Error(await response.text());
}

await writeFile('header-footer.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/header-footer',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'headerText': 'Quarterly Report', 'footerText': 'Page {page} of {total}'}
    },
)
response.raise_for_status()

with open('header-footer.pdf', 'wb') as f:
    f.write(response.content)

Error codes

401invalid_api_key

L’en-tête x-api-key manque, est invalide ou a été renouvelé.

402insufficient_credits

Le compte ne dispose pas d’assez d’API Credits.

422pdf_tool_processing_failed

Le fichier, les options ou la structure PDF n’ont pas pu être traités. Les Credits sont recrédités automatiquement en cas d’échec.

Limits

Nécessite un PDF lisible ou des données d’entrée valides.
Appelez l’API côté serveur pour ne pas exposer votre API Key.
Testez des fichiers représentatifs avant un traitement massif.

Response headers

header-footer.pdf avec en-têtes indiquant les Credits consommés et le solde restant.

Content-Type: Type MIME du fichier généré, généralement application/pdf ou application/zip.
Content-Disposition: Nom de téléchargement du fichier généré.
X-Credits-Charged: Credits facturés pour la requête réussie.
X-Credit-Balance: Solde d’API Credits après la requête.

FAQ

Quel est le prix de API en-tête et pied PDF ?

Une requête réussie utilise des API Credits ; les traitements échoués sont recrédités automatiquement. Chaque utilisateur connecté reçoit 100 free API Credits par mois, et 1,000 Credits = $1.

Les outils web utilisent-ils des API Credits ?

Non. Les outils traités dans le navigateur ne consomment pas d’API Credits. Seuls les appels avec API Key sont facturés.

Puis-je appeler l’API depuis le navigateur ?

Ce n’est pas recommandé. Gardez l’API Key côté serveur, dans une file ou une automatisation backend.

Start with 100 free API Credits

Create an API Key, test API en-tête et pied PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs