# Übersicht der Aktionen

Was eine Aktion ist, der nach Fähigkeiten gruppierte Katalog und wie die Ausgabe einer Aktion zur Eingabe der nächsten wird.

Eine **Aktion** ist eine einzelne, reine Umwandlung eines PDFs, die als ein
Endpoint bereitgestellt wird. Sie senden ein Dokument, die Aktion macht genau
eine Sache damit (zusammenführen, mit einem Wasserzeichen versehen,
verschlüsseln, drehen, aufteilen), und Sie erhalten das Ergebnis zurück.
Aktionen halten keinen Zustand und teilen keinen Kontext; jeder Aufruf steht für
sich. Genau diese Einheitlichkeit erlaubt es Ihnen, sie zu Pipelines
zusammenzustecken.

## Was eine Aktion ist

Jede Aktion ist ein `POST` an `/v1/<action>`, wobei `<action>` der technische
Name aus den Tabellen unten ist. Alle folgen demselben
[Vertrag für Anfrage und Antwort](/docs/api/requests-and-responses): einem
Anfragetext vom Typ `multipart/form-data` mit dem PDF-Eingabedokument im Feld
`file`, authentifiziert über den Header `X-API-Key`. Die meisten geben ein
einzelnes `application/pdf` zurück; die Familie der Aktionen zum Aufteilen gibt
mehrere Dokumente zurück.

## Der Katalog

Siebzehn Aktionen, nach Fähigkeiten gruppiert. Jede verweist auf ihre
vollständige Referenz.

### Zusammenführen und aufteilen

| Aktion | Route | Was sie tut |
| --- | --- | --- |
| [Dokumente zusammenführen](/docs/api/merge-pdf-documents) | `/v1/merge_documents` | Ein geordnetes Array von PDF-Dokumenten zu einem Dokument kombinieren. |
| [Nach Seitenanzahl aufteilen](/docs/api/split-pdf-by-page-count) | `/v1/split_by_page_count` | Ein PDF in aufeinanderfolgende Teile mit fester Seitenanzahl zerlegen. |
| [An einer Seite aufteilen](/docs/api/split-pdf-at-page) | `/v1/split_at_page` | Ein PDF an einer Trennstelle in zwei Teile aufteilen. |
| [Nach Dateigröße aufteilen](/docs/api/split-pdf-by-file-size) | `/v1/split_by_size` | Ein PDF in Teile zerlegen, die eine Grenze in Bytes jeweils nicht überschreiten. |
| [In Seitengruppen aufteilen](/docs/api/split-pdf-into-page-groups) | `/v1/split_by_groups` | Ein PDF in Seitengruppen zerlegen, die Sie selbst festlegen. |

Die vier Aktionen zum Aufteilen erzeugen jeweils mehrere Dokumente; die
Verpackung wählen Sie mit dem Header `Accept`. Siehe
[Antwortformate](/docs/api/response-formats).

### Wasserzeichen

| Aktion | Route | Was sie tut |
| --- | --- | --- |
| [Textwasserzeichen hinzufügen](/docs/api/add-text-watermark-to-pdf) | `/v1/add_text_watermark` | Bis zu drei Zeilen gestalteten Text auf den Seiten aufbringen. |
| [Bildwasserzeichen hinzufügen](/docs/api/add-image-watermark-to-pdf) | `/v1/add_image_watermark` | Ein PNG- oder JPEG-Bild, etwa ein Logo, auf den Seiten aufbringen. |

### Passwörter und Sicherheit

| Aktion | Route | Was sie tut |
| --- | --- | --- |
| [Passwort hinzufügen](/docs/api/add-password-to-pdf) | `/v1/add_password` | Ein Dokument mit einem Passwort zum Öffnen und/oder einem Passwort für Berechtigungen verschlüsseln. |
| [Passwort entfernen](/docs/api/remove-password-from-pdf) | `/v1/remove_password` | Ein Dokument entschlüsseln, dessen Passwort Sie kennen. |
| [Einschränkungen hinzufügen](/docs/api/add-restrictions-to-pdf) | `/v1/add_restrictions` | Berechtigungs-Flags für Drucken, Kopieren und Bearbeiten setzen. |
| [Einschränkungen entfernen](/docs/api/remove-restrictions-from-pdf) | `/v1/remove_restrictions` | Die Berechtigungs-Flags eines Dokuments zurücksetzen. |
| [Signaturen entfernen](/docs/api/remove-signatures-from-pdf) | `/v1/remove_signatures` | Digitale Signaturen entfernen, damit das Dokument bearbeitet werden kann. |

### Seiten

| Aktion | Route | Was sie tut |
| --- | --- | --- |
| [Seiten extrahieren](/docs/api/extract-pages-from-pdf) | `/v1/extract_pages` | Eine gewählte Menge von Seiten behalten und den Rest verwerfen. |
| [Seiten entfernen](/docs/api/remove-pages-from-pdf) | `/v1/remove_pages` | Eine gewählte Menge von Seiten verwerfen und den Rest behalten. |
| [Seiten drehen](/docs/api/rotate-pages-in-pdf) | `/v1/rotate_pages` | Gewählte Seiten um ein Vielfaches von 90 Grad drehen. |
| [Seitenreihenfolge umkehren](/docs/api/reverse-pages-of-pdf) | `/v1/reverse_pages` | Die Reihenfolge der Seiten komplett umkehren. |
| [Seiten neu anordnen](/docs/api/reorder-pages-of-pdf) | `/v1/reorder_pages` | Seiten in eine vom Aufrufer angegebene Reihenfolge bringen. |

## Wie sich Aktionen zusammensetzen

Da jede Aktion ein PDF entgegennimmt und (bei Aktionen mit einer einzelnen
Ausgabe) ein PDF zurückgibt, ist die Ausgabe einer Aktion eine gültige Eingabe
für die nächste. Zwischen den Aufrufen wird nichts gespeichert, Sie setzen also
zusammen, indem Sie Bytes weiterreichen: Halten Sie die Antwort einer Anfrage im
Arbeitsspeicher und senden Sie sie als `file` der nächsten.

Eine typische Pipeline liest sich von links nach rechts:

```text
merge_documents  →  add_text_watermark  →  add_password
   (many PDFs)         (one watermarked)      (one encrypted)
```

Der Leitfaden [Aktionen verketten](/docs/api/chaining-actions) zeigt das
durchgehend im Code, ohne die Festplatte zu berühren.

## Einzelne Ausgabe oder mehrere Ausgaben

Die meisten Aktionen geben ein Dokument vom Typ `application/pdf` zurück. Die
vier Aktionen zum Aufteilen geben viele zurück und lassen Sie über die
Inhaltsaushandlung wählen, wie diese verpackt werden (ein ZIP-Archiv, ein
JSON-Umschlag oder ein Antworttext vom Typ `multipart/mixed`). Dieser
Mechanismus hat genau einen Ort:
[Antwortformate](/docs/api/response-formats).