PDF Tools API

API édition métadonnées PDF

Ajoutez modifier les métadonnées PDF à 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/edit-metadata

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

Use case

À utiliser pour normaliser titres, auteurs et mots-clés pour documents générés ou archivés. 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/edit-metadata \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"title":"Updated title","author":"iTextMaster","subject":"API generated document"}' \
  --output metadata-updated.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/edit-metadata \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"title":"Updated title","author":"iTextMaster","subject":"API generated document"}' \
  --output metadata-updated.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/edit-metadata \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"title":"Updated title","author":"iTextMaster","subject":"API generated document"}
  }' \
  --output metadata-updated.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/edit-metadata', {
  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: {"title":"Updated title","author":"iTextMaster","subject":"API generated document"}
})
});

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

await writeFile('metadata-updated.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/edit-metadata',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'title': 'Updated title', 'author': 'iTextMaster', 'subject': 'API generated document'}
    },
)
response.raise_for_status()

with open('metadata-updated.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

metadata-updated.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 édition métadonnées 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 édition métadonnées PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs