PDF Tools API

API de biffure PDF

Ajoutez biffer des zones 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/pdf-redaction

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

Use case

À utiliser pour masquer données personnelles, montants ou notes internes pour RGPD et partage externe. 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/pdf-redaction \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}' \
  --output redacted.pdf

Multipart example

curl -X POST https://itextmaster.com/api/external/pdf-tools/pdf-redaction \
  -H 'x-api-key: YOUR_API_KEY' \
  -F 'file=@input.pdf;type=application/pdf' \
  -F 'options={"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}' \
  --output redacted.pdf

JSON base64 example

curl -X POST https://itextmaster.com/api/external/pdf-tools/pdf-redaction \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "file": { "name": "input.pdf", "dataBase64": "JVBERi0xLjcK..." },
    "options": {"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}
  }' \
  --output redacted.pdf

Node.js example

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

const response = await fetch('https://itextmaster.com/api/external/pdf-tools/pdf-redaction', {
  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: {"areas":[{"page":1,"x":72,"y":120,"width":180,"height":36,"replacementText":"REDACTED"}],"color":{"r":0,"g":0,"b":0}}
})
});

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

await writeFile('redacted.pdf', Buffer.from(await response.arrayBuffer()));

Python example

import os
import requests

response = requests.post(
    'https://itextmaster.com/api/external/pdf-tools/pdf-redaction',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': os.environ['ITEXTMASTER_API_KEY'],
    },
    json={
        'file': {'name': 'input.pdf', 'dataBase64': 'JVBERi0xLjcK...'},
        'options': {'areas': [{'page': 1, 'x': 72, 'y': 120, 'width': 180, 'height': 36, 'replacementText': 'REDACTED'}], 'color': {'r': 0, 'g': 0, 'b': 0}}
    },
)
response.raise_for_status()

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

redacted.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 de biffure 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 de biffure PDF, and buy more Credits only when automation volume grows.

Get API Key View full API docs