REST API

Eine REST-API (Representational State Transfer Application Programming Interface) ist eine Sammlung von Webservice-Endpunkten, die standardmäßige HTTP-Methoden — GET, POST, PUT, PATCH und DELETE — verwenden, um Ressourcen zu erstellen, zu lesen, zu aktualisieren und zu entfernen. Jede Ressource wird durch eine URL identifiziert, und der Server antwortet mit strukturierten Daten, typischerweise JSON. REST-APIs folgen einem zustandslosen Anfrage-Antwort-Muster, was bedeutet, dass jeder Aufruf alle Informationen enthält, die der Server zur Verarbeitung benötigt, ohne auf vorherige Anfragen angewiesen zu sein. Sie sind der am weitesten verbreitete Ansatz für den programmatischen Datenaustausch zwischen Webanwendungen.

Für digitale Publisher verwandelt eine REST-API eine [Flipbook](/glossary/flipbook)-Plattform von einem eigenständigen Dashboard in einen programmierbaren Baustein, der sich in größere Workflows einfügt. Sie ermöglicht Automatisierung — PDF-Upload, Flipbook-Erstellung, Abruf von [Analytics](/glossary/analytics-dashboard)-Daten — ohne manuellen Eingriff. Teams, die Hunderte von Dokumenten veröffentlichen, sparen erheblich Zeit durch die Automatisierung wiederkehrender Aufgaben. Eine REST-API öffnet auch die Tür zu Integrationen mit CRMs, Marketing-Plattformen und Content-Management-Systemen und macht die Publishing-Plattform zum Teil einer vernetzten Werkzeugkette.

FlipLink bietet [API-Zugang](/features/api-access), der Entwicklern ermöglicht, Flipbooks und Dokumente programmatisch zu erstellen, zu aktualisieren, aufzulisten und zu löschen. Du kannst PDFs hochladen, Viewer-Einstellungen konfigurieren, Analytics-Daten abrufen und Leads über authentifizierte API-Endpunkte verwalten. Die API integriert sich in das umfassende Ökosystem für [Automatisierung und Integrationen](/features/automation-and-integrations), einschließlich [Webhooks](/glossary/webhook), die Echtzeit-Events an deine eigenen Systeme senden. Die Authentifizierung verwendet API-Schlüssel, die an dein Konto gebunden sind, und alle Anfragen und Antworten verwenden das JSON-Format. Rate-Limits sind dokumentiert, damit du zuverlässige Automatisierungen aufbauen kannst.

REST-APIs basieren auf einer kleinen Menge von Konventionen, die sie vorhersehbar machen: - **Ressourcen und URLs** — jede Entität (ein Flipbook, ein Lead, ein Analytics-Bericht) hat eine eindeutige URL. Beispielsweise identifiziert `/api/get/abc123` ein bestimmtes Flipbook. - **HTTP-Methoden bilden Aktionen ab** — GET liest, POST erstellt, PUT/PATCH aktualisiert, DELETE entfernt. Die Methode teilt dem Server mit, was du tun möchtest; die URL gibt an, welche Ressource betroffen ist. - **Zustandslosigkeit** — der Server merkt sich keine vorherigen Anfragen. Jeder Aufruf enthält sein eigenes Authentifizierungstoken und Parameter. Das vereinfacht die Skalierung, da jeder Server im Cluster jede Anfrage bearbeiten kann. - **Statuscodes** — der Server antwortet mit Standard-HTTP-Codes: 200 für Erfolg, 201 für erstellt, 400 für fehlerhafte Anfrage, 401 für nicht autorisiert, 404 für nicht gefunden, 429 für Rate-Limit überschritten. - **Paginierung** — Listen-Endpunkte liefern Ergebnisse seitenweise, mit Metadaten zur Gesamtanzahl und Links zur nächsten Seite.

**„REST-API und API sind dasselbe."** REST ist ein Architekturstil für APIs. Andere Stile umfassen GraphQL, gRPC und SOAP. Wenn jemand „API" ohne Zusatz sagt, meint er meist REST, aber die Begriffe sind nicht austauschbar. **„REST-APIs erfordern JSON."** JSON ist das gängigste Format, aber REST selbst schreibt kein bestimmtes Datenformat vor. Einige APIs unterstützen XML oder andere Formate über Content-Negotiation-Header. In der Praxis verwenden die meisten modernen REST-APIs — einschließlich der von FlipLink — ausschließlich JSON. **„Zustandslos bedeutet, der Server vergisst alles."** Zustandslos bezieht sich auf einzelne Anfragen, nicht auf die Plattform als Ganzes. Der Server speichert weiterhin deine Flipbooks, Einstellungen und Daten in seiner Datenbank. Zustandslos bedeutet, dass jeder API-Aufruf seine eigene Authentifizierung und seinen eigenen Kontext mitbringen muss.

**Was ist der Unterschied zwischen einer REST-API und einem [Webhook](/glossary/webhook)?** Eine REST-API erfordert, dass deine Anwendung Anfragen initiiert — du fragst Daten an oder sendest Befehle. Ein [Webhook](/glossary/webhook) funktioniert in der umgekehrten Richtung: Der Server sendet Events an deine Anwendung, wenn etwas passiert (ein neuer Lead erfasst, ein Flipbook angesehen). Viele Workflows nutzen beides: REST-API für On-Demand-Operationen und Webhooks für Echtzeit-Benachrichtigungen. **Was ist eine RESTful API?** „RESTful" bedeutet, dass eine API den REST-Prinzipien folgt: ressourcenbasierte URLs, Standard-HTTP-Methoden, zustandslose Kommunikation und strukturierte Antworten. Die Begriffe „REST-API" und „RESTful API" werden in der Praxis synonym verwendet. **Brauche ich Programmierkenntnisse, um eine REST-API zu nutzen?** Eigener Code bietet die größte Flexibilität, aber viele No-Code-Plattformen wie Zapier, Make und n8n können über visuelle Oberflächen mit REST-APIs interagieren. FlipLinks [API-Zugang](/features/api-access) funktioniert sowohl mit eigenem Code als auch mit Automatisierungsplattformen.

Eine REST-API ist die Standardschnittstelle für den programmatischen Zugang zu Webdiensten. Für FlipLink-Nutzer bedeutet das, dass jeder Workflow, der die Erstellung, Verwaltung oder Analyse von Publikationen umfasst, automatisiert, integriert und über die Möglichkeiten eines Dashboards hinaus skaliert werden kann.