PDF Redaction API — PII programmgesteuert schwärzen | PDF Schwärzen AI

Entwickler

Redaction API

PDFs programmgesteuert schwärzen mit derselben sicheren Pipeline wie die Web-App: Azure OCR + PII-Erkennung + irreversible rasterisierte Schwärzung.

API-Key erhalten OpenAPI herunterladen Ausprobieren (ohne Key)

Docs Developers (Markdown)llms.txt

Async-Jobs

Eine oder mehrere PDFs hochladen, Status pollen, dann geschwärzte Outputs herunterladen.

PII-Kontrollen

PII-Kategorien pro Job wählen, Begriffe zum Immer-Schwärzen oder Immer-Sichtbar-Lassen festlegen und Standard-Einstellungen im Dashboard behalten.

Aufbewahrung

Standardmäßig no-retention für API-Workflows, optionaler Studio-Review-Modus bei Bedarf.

Kurz gesagt

Ja — PDF Schwärzen AI bietet eine REST API, um PDFs und Bilder programmgesteuert zu schwärzen. Du sendest ein Dokument per POST, die API erkennt PII mit KI (Namen, E-Mail-Adressen, IBANs und mehr) plus OCR für Scans, und du kannst Begriffe übergeben, die immer geschwärzt oder sichtbar gelassen werden sollen. Danach liefert sie eine irreversible, geflättete geschwärzte Datei zurück. Die API ist in jedem Plan verfügbar und nutzt dasselbe Seitenkontingent wie dein Web-App-Abonnement oder Credit-Guthaben.

Konzepte

Das Wichtigste: Auth, Kontingent, Retries, Aufbewahrung und unterstützte PII-Kategorien.

Auth: Key in X-API-Key senden (Keys serverseitig halten).
Pläne und Kontingent: Die API ist in jedem Plan verfügbar und verbraucht dasselbe Seitenkontingent wie Web-Uploads.
Idempotenz: X-Idempotency-Key bei Retries von POST /v1/jobs verwenden.
Aufbewahrung: ephemeral löscht Originale nach Verarbeitung; studio behält Originale + Masken für Studio-Review.
Statuses: uploaded → analyzing → redacted (oder error).
PII-Kategorien: Person, Email, PhoneNumber, Address, Organization, Date, IBAN, CreditCard.

Authentication

Use an API key for server-to-server calls. Do not put API keys in browsers or mobile apps.

Validate your key

curl -X GET \
  'https://www.redact-pdf.ai/v1/me' \
  -H 'X-API-Key: YOUR_API_KEY'

Header: X-API-Key: YOUR_API_KEY

Security checklist

Store keys in your server environment (not in client code).
Use one key per environment (dev/staging/prod) to reduce blast radius.
Prefer short-lived workers and job queues for large batches.
Log request IDs (from error responses) for support/debugging.

Quickstart

Minimale Beispiele, um schnell zu starten.

Job erstellen

curl -X POST \
  'https://www.redact-pdf.ai/v1/jobs' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -F 'files=@contract.pdf;type=application/pdf' \
  -F 'pii_categories=["Person","Email","PhoneNumber"]' \
  -F 'pii_included_terms=["Project Titan"]' \
  -F 'pii_excluded_terms=["Acme Corp"]' \
  -F 'retention=ephemeral'

Die API liefert sofort eine Job-ID zurück. Die Verarbeitung läuft asynchron.

Beispielantwort

{
  "job_id": "b3f2b2e0-6f30-4f3e-8a7b-2f2a20a7d91c",
  "status": "analyzing",
  "documents": [
    { "id": "7f4f4f85-6b7a-4f88-9a8a-7b9a6a2d2fd0", "status": "uploaded" }
  ]
}

Job pollen bis Status “redacted”, dann Outputs pro Dokument herunterladen.

Error handling

Errors are JSON with a stable code. Treat quota and rate limits as actionable signals.

Common codes

quota_exceeded (HTTP 402): buy credits or upgrade.
rate_limited (HTTP 429): backoff and retry.
invalid_request (HTTP 400): fix parameters.
unauthorized (HTTP 401): key missing/invalid.

Example error response

{
  "error": "Insufficient quota",
  "code": "quota_exceeded",
  "request_id": "req_123"
}

The request_id helps correlate logs and support requests.

PII categories

Choose which PII types to redact per job. If you omit categories, your dashboard defaults apply.

Category	What it targets
Person	People names
Email	Email addresses
PhoneNumber	Phone numbers (validated patterns)
Address	Postal addresses
Organization	Company / organization names
Date	Dates and date-times
IBAN	International bank account numbers
CreditCard	Credit card numbers

Tip: if you need a term to never be redacted, set excluded terms in the dashboard preferences.

API-Referenz (v1)

Praktische Request-Beispiele für die Kernendpoints. Lade die OpenAPI-Datei für das vollständige Schema herunter.

Job pollen

curl -X GET \
  'https://www.redact-pdf.ai/v1/jobs/b3f2b2e0-6f30-4f3e-8a7b-2f2a20a7d91c' \
  -H 'X-API-Key: YOUR_API_KEY'

Pollen, bis der Job einen terminalen Status erreicht (redacted oder error).

Output herunterladen

curl -L \
  -H 'X-API-Key: YOUR_API_KEY' \
  'https://www.redact-pdf.ai/v1/documents/7f4f4f85-6b7a-4f88-9a8a-7b9a6a2d2fd0/output' \
  -o contract-redacted.pdf

Lade das geschwärzte PDF herunter, sobald der Dokumentstatus redacted ist.

Job löschen

curl -X DELETE \
  -H 'X-API-Key: YOUR_API_KEY' \
  'https://www.redact-pdf.ai/v1/jobs/b3f2b2e0-6f30-4f3e-8a7b-2f2a20a7d91c'

Löscht den Job und zugehörige Dateien (abhängig von der Aufbewahrung).

Best practices

Nutze X-Idempotency-Key für Retries (Netzwerk-Timeouts passieren).
API-Keys nicht in Browsern oder mobilen Apps verwenden. Nur serverseitig aufrufen.
Beim Polling exponentielles Backoff nutzen; 1–2s Intervalle für kurze Jobs.
402 und 429 als klare Signale behandeln (Quota / Rate limit).

API-Key erhalten OpenAPI herunterladen Ausprobieren (ohne Key)

FAQ zur PDF Redaction API

Gibt es eine API zum Schwärzen von PDFs?

Ja. PDF Schwärzen AI stellt eine REST API bereit, die PDFs und Bilder programmgesteuert schwärzt, mit derselben KI-PII-Erkennung und OCR-Pipeline wie die Web-App, und liefert eine irreversible, geflättete Datei zurück.

Wie schwärze ich ein PDF über die API?

Sende deine Datei per POST an den /v1/jobs-Endpoint mit deinem API-Key und den gewählten PII-Kategorien, polle den Job bis er fertig ist, und lade dann den geschwärzten Output herunter. Siehe die curl-Beispiele oben.

Unterstützt die Redaction API Stapel- oder Massenverarbeitung?

Ja. Ein einzelner Job kann mehrere Dokumente enthalten, und du kannst Jobs gleichzeitig ausführen, um große Datenmengen zu verarbeiten.

Ist die Redaction API DSGVO-konform, und wo werden die Daten verarbeitet?

Die Verarbeitung läuft auf Microsoft Azure in der EU (Frankfurt) und der Schweiz, verschlüsselt bei der Übertragung und im Ruhezustand, und Dokumente werden niemals zum Trainieren von KI-Modellen verwendet.

Kann die API Dateien direkt nach der Verarbeitung löschen?

Ja. Nutze die "ephemeral"-Aufbewahrung, damit Dateien direkt nach Abschluss des Jobs gelöscht werden; andernfalls gilt die Standard-Aufbewahrung und du kannst jeden Job über die API löschen.

Was kostet die Redaction API?

Die API ist in jedem Plan enthalten. API-Jobs nutzen dasselbe Seitenkontingent wie dein Abonnement und deine Credit-Pakete, ohne separaten API-Tarif oder Zusatzoption.