# Einführung in die API von PDF Blocks

Was PDF Blocks ist, das Modell, dem jede Aktion folgt, und der Katalog dessen, was die API alles kann.

PDF Blocks ist eine sichere, schnelle, *stateless* HTTP-API für die Arbeit mit
PDF-Dokumenten. Senden Sie ein Dokument, nennen Sie eine Aktion, und Sie
bekommen das verarbeitete PDF direkt in der Antwort zurück. Es gibt keinen
Kontozustand zu verwalten, nach einer Anfrage wird nichts gespeichert, und es
gibt kein SDK zu installieren: Jede Aktion ist ein einziger authentifizierter
HTTPS-Aufruf, den Sie aus jeder Sprache heraus machen können.

## Das mentale Modell

Ein PDF hinein, ein PDF heraus. Jede Aktion ist eine reine Transformation: Sie
nimmt ein Dokument entgegen (dazu ein paar Parameter), gibt ein neues Dokument
zurück und behält nichts. Sie senden `multipart/form-data` mit Ihrem PDF in
einem Feld `file`, und eine Aktion mit einer einzigen Ausgabe antwortet mit
`200 OK` und `application/pdf`, dem fertigen Dokument als Antworttext.

Weil jede Ausgabe selbst ein gültiges PDF ist, ist sie eine gültige Eingabe für
die nächste Aktion. Damit lassen sich Aktionen zusammensetzen: mehrere Dateien
zusammenführen, auf dem Ergebnis ein Wasserzeichen aufbringen, es dann
verschlüsseln, wobei jeder Schritt den nächsten speist. Siehe [Aktionen
verketten](/docs/api/chaining-actions), um eine Pipeline zu bauen, ohne je die
Festplatte zu berühren.

## Der Aktionskatalog

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

### Zusammenführen und aufteilen

<CardGroup cols={3}>
  <Card title="Dokumente zusammenführen" href="/docs/api/merge-pdf-documents">
    Eine geordnete Liste von PDFs zu einem einzigen Dokument kombinieren.
  </Card>
  <Card title="Nach Seitenanzahl aufteilen" href="/docs/api/split-pdf-by-page-count">
    In Blöcke fester Größe zerlegen.
  </Card>
  <Card title="An einer Seite aufteilen" href="/docs/api/split-pdf-at-page">
    An einer gewählten Seitengrenze zerlegen.
  </Card>
  <Card title="Nach Dateigröße aufteilen" href="/docs/api/split-pdf-by-file-size">
    Die Größe jedes Teils in Bytes begrenzen.
  </Card>
  <Card title="In Seitengruppen aufteilen" href="/docs/api/split-pdf-into-page-groups">
    Seiten nach einem Muster gruppieren, das Sie festlegen.
  </Card>
</CardGroup>

### Wasserzeichen

<CardGroup cols={3}>
  <Card title="Textwasserzeichen hinzufügen" href="/docs/api/add-text-watermark-to-pdf">
    Bis zu drei Textzeilen aufbringen.
  </Card>
  <Card title="Bildwasserzeichen hinzufügen" href="/docs/api/add-image-watermark-to-pdf">
    Ein Logo oder ein Bild aufbringen.
  </Card>
</CardGroup>

### Passwörter und Sicherheit

<CardGroup cols={3}>
  <Card title="Passwort hinzufügen" href="/docs/api/add-password-to-pdf">
    Ein Dokument verschlüsseln.
  </Card>
  <Card title="Passwort entfernen" href="/docs/api/remove-password-from-pdf">
    Ein Dokument mit bekanntem Passwort entschlüsseln.
  </Card>
  <Card title="Einschränkungen hinzufügen" href="/docs/api/add-restrictions-to-pdf">
    Berechtigungs-Flags setzen.
  </Card>
  <Card title="Einschränkungen entfernen" href="/docs/api/remove-restrictions-from-pdf">
    Die Berechtigungs-Flags zurücksetzen.
  </Card>
  <Card title="Signaturen entfernen" href="/docs/api/remove-signatures-from-pdf">
    Digitale Signaturen entfernen.
  </Card>
</CardGroup>

### Seiten

<CardGroup cols={3}>
  <Card title="Seiten extrahieren" href="/docs/api/extract-pages-from-pdf">
    Eine Teilmenge der Seiten behalten.
  </Card>
  <Card title="Seiten entfernen" href="/docs/api/remove-pages-from-pdf">
    Eine Teilmenge der Seiten verwerfen.
  </Card>
  <Card title="Seiten drehen" href="/docs/api/rotate-pages-in-pdf">
    Seiten um 90°, 180° oder 270° drehen.
  </Card>
  <Card title="Seitenreihenfolge umkehren" href="/docs/api/reverse-pages-of-pdf">
    Die Seitenreihenfolge umdrehen.
  </Card>
  <Card title="Seiten neu anordnen" href="/docs/api/reorder-pages-of-pdf">
    Seiten in beliebiger Reihenfolge neu anordnen.
  </Card>
</CardGroup>

Das ganze Bild, also die Namenskonvention, die Art, wie Aktionen sich
zusammensetzen, und der Ort, an dem jede einzelne dokumentiert ist, steht in
der [Übersicht der Aktionen](/docs/api/actions-overview).

## Was sie auszeichnet

- **Schnell.** Aktionen sind Transformationen mit einem einzigen Zweck, ohne
  Warteschlangen und ohne Roundtrips. Sie senden eine Anfrage und schreiben das
  Ergebnis direkt als Stream in eine Datei.
- **Sicher und stateless.** Anfragen laufen ausschließlich über HTTPS und
  authentifizieren sich mit einem geheimen Schlüssel. Dokumente werden in der
  Region verarbeitet und niemals gespeichert: Sobald die Antwort geschrieben
  ist, bleibt nichts zurück.
- **Regionale Datenresidenz.** Derselbe Katalog läuft in zehn Regionen, sodass
  Ihre Dokumente dort verarbeitet werden können, wo Ihre Compliance es
  verlangt. Richten Sie eine Anfrage an die Basis-URL der Region, alles andere
  ist identisch.

| Region                 | Basis-URL                         |
| ---------------------- | --------------------------------- |
| Global                 | `https://api.pdfblocks.com`       |
| USA                    | `https://us.api.pdfblocks.com`    |
| HIPAA USA              | `https://hipaa.api.pdfblocks.com` |
| Europäische Union      | `https://eu.api.pdfblocks.com`    |
| Vereinigtes Königreich | `https://uk.api.pdfblocks.com`    |
| Kanada                 | `https://ca.api.pdfblocks.com`    |
| Australien             | `https://au.api.pdfblocks.com`    |
| Japan                  | `https://jp.api.pdfblocks.com`    |
| Indien                 | `https://in.api.pdfblocks.com`    |
| Brasilien              | `https://br.api.pdfblocks.com`    |

Alle Details finden Sie unter [Regionen und
Datenresidenz](/docs/api/regions-and-data-residency).

## Wie es weitergeht

<CardGroup cols={2}>

<Card title="Schnellstart" href="/docs/api/quickstart">
  Den ersten authentifizierten Aufruf machen und in fünf Minuten ein
  verarbeitetes PDF in der Hand halten.
</Card>

<Card title="Authentifizierung" href="/docs/api/authentication">
  Einen API-Schlüssel holen und ihn bei jeder Anfrage korrekt senden.
</Card>

</CardGroup>