Use case
À utiliser pour donner des repères stables aux dossiers fusionnés, audits et validations. L’outil web reste adapté à la revue manuelle ; l’API sert aux traitements serveur répétables.
PDF Tools API
API numérotation PDF
Ajoutez ajouter des numéros de page à votre backend, vos lots ou votre produit sans maintenir votre propre service 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_keyL’en-tête x-api-key manque, est invalide ou a été renouvelé.
402
insufficient_creditsLe compte ne dispose pas d’assez d’API Credits.
422
pdf_tool_processing_failedLe 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
numbered.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 numérotation 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 numérotation PDF, and buy more Credits only when automation volume grows.