Headless API

Software besteht meist aus zwei Teilen. Der eine Teil verwaltet die Daten und die Regeln, etwa welche Produkte es gibt und was sie kosten. Der andere Teil ist das, was man auf dem Bildschirm sieht: Knöpfe, Bilder, Menüs. Eine Headless API liefert nur den ersten Teil. „Headless“ heißt wörtlich „kopflos“, und der fehlende Kopf ist genau diese sichtbare Oberfläche. API steht für Programmierschnittstelle: eine feste Liste von Anfragen, die ein Programm an ein anderes Programm stellen darf, und die dafür verabredeten Antworten. Ein Onlineshop mit Headless API antwortet also nicht mit einer fertigen Webseite, sondern mit reinen Daten wie „Artikel 7231, Preis 49,90 Euro, 12 auf Lager“.

Warum Firmen ihre Oberfläche abtrennen

Früher war beides fest verschweißt. Ein Shopsystem enthielt die Datenbank und gleich das Design der Seite dazu. Solange es nur Desktop-Browser gab, funktionierte das gut. Heute kaufen Menschen über die Website, über eine Handy-App, über Sprachassistenten und an Terminals im Laden. Bei einem verschweißten System müsste man die Produktdaten für jeden dieser Kanäle neu pflegen.

Mit einer Headless API gibt es die Daten nur einmal. Jeder Kanal fragt dieselbe Schnittstelle und baut daraus seine eigene Darstellung. Ändert die Marketingabteilung einen Preis, gilt er sofort überall. Das spart Arbeit und verhindert Widersprüche zwischen App und Website.

Der zweite Grund ist Tempo. Ein Designteam kann die Website komplett neu gestalten, ohne dass jemand die Warenwirtschaft anfasst. Umgekehrt lässt sich das System dahinter austauschen, solange die Schnittstelle gleich bleibt. Diese Trennung nennt man Entkopplung, und sie ist der eigentliche Kern der Idee.

Was zwischen Anfrage und Antwort passiert

Der Ablauf ist immer derselbe. Ein Programm schickt eine Anfrage an eine Adresse im Netz, zum Beispiel an /produkte/7231. Der Server sucht die Daten heraus und schickt sie zurück. Die Antwort kommt in einem Format namens JSON, das für Maschinen leicht lesbar ist und ungefähr wie eine strukturierte Liste aus Begriffen und Werten aussieht.

Was dann mit diesen Daten geschieht, entscheidet allein das anfragende Programm. Die Handy-App zeigt den Preis groß und fett an, die Website setzt ihn neben ein Foto, das Kassendisplay druckt ihn schlicht aus. Die API weiß davon nichts. Genau das macht sie kopflos.

Ein verbreiteter Irrtum ist, dass jede API automatisch headless sei. Der Unterschied liegt in der Vollständigkeit: Bei einer echten Headless-Architektur lässt sich das gesamte Produkt allein über die Schnittstelle bedienen, ohne versteckte Funktionen, die nur die mitgelieferte Oberfläche kann. Der Preis dafür ist Aufwand. Wer headless arbeitet, muss die Oberfläche selbst bauen, inklusive Suche, Login und Warenkorb. Für ein kleines Projekt ist ein fertiges Komplettsystem oft die klügere Wahl.

Von Shopsystemen bis zu KI-Modellen

Am häufigsten trifft man den Begriff bei Redaktionssystemen und im Onlinehandel. Ein Headless CMS verwaltet Texte und Bilder einer Nachrichtenseite, ohne vorzuschreiben, wie ein Artikel aussieht. Anbieter wie Contentful oder Strapi arbeiten so. Im Handel bieten Shopify und Commercetools entsprechende Schnittstellen an, mit denen Marken eigene Einkaufserlebnisse bauen.

Auch die meisten KI-Dienste sind im Kern headless. OpenAI, Anthropic und Google verkaufen zwar sichtbare Chatprogramme, verdienen aber viel Geld mit dem reinen Zugang zum Modell. Ein Unternehmen schickt Text hin und bekommt Text zurück. Ob daraus ein Kundenchat, eine Übersetzungsfunktion oder ein Suchfeld wird, entscheidet der Kunde selbst.

In Wirtschaftsmeldungen taucht „headless“ deshalb oft als Signal für ein Geschäftsmodell auf. Wer Schnittstellen verkauft, verdient pro Anfrage und bleibt für die Kunden im Hintergrund. Das bringt stabile Einnahmen, macht die Marke aber weniger sichtbar. Manche Anbieter fahren beides parallel: eine eigene App für die Bekanntheit, die API für den Umsatz.