Was ist eine REST API?

Eine REST API ist eine Schnittstelle, die Ressourcen über HTTP mit einem kleinen Set an Verben und vorhersehbaren URL-Mustern bereitstellt. REST steht für Representational State Transfer und ist ein Architekturstil, kein striktes Protokoll. Die Praxis, GET, POST, PUT, PATCH und DELETE gegen Ressourcen-URLs einzusetzen, hat sich als Standard für die Integration von Webservices durchgesetzt.

Definition

In einem typischen REST-Design hat jede Ressource eine eigene URL, und Operationen auf der Ressource entsprechen HTTP-Verben. Ein Produkt liegt zum Beispiel unter /products/123, lesbar per GET, änderbar per PATCH und löschbar per DELETE. Antworten sind meist JSON, Statuscodes signalisieren Ergebnisse, und Header tragen Metadaten wie Caching-Direktiven und Authentifizierungs-Token.

Warum es zählt

REST APIs sind die Lingua franca moderner Commerce-Stacks. PIM-Systeme, OMS, Zahlungsanbieter, Suchmaschinen und Content-Plattformen exponieren REST-Endpoints, die Storefronts und Integrations-Layer konsumieren. Ihre Einfachheit, breite Tooling-Unterstützung und expliziten HTTP-Semantiken machen sie für öffentliche Integrationen besonders geeignet.

REST vs. GraphQL

REST glänzt bei klaren, ressourcenorientierten Interaktionen und profitiert von nativem HTTP-Caching. GraphQL glänzt bei flexiblen Lesezugriffen, bei denen der Client die Antwortstruktur bestimmt. In der Praxis kombinieren die meisten Composable-Commerce-Stacks beides: REST für Service-zu-Service-Integration und Webhooks, GraphQL oder BFF für das Frontend. Die Wahl hängt von Teamerfahrung, Ökosystem und Vorhersehbarkeit der Client-Bedürfnisse ab.

Verwandt

Mehr dazu: Composable Digital Experience Platform · Composable Headless Frontend.