Engineering Library

APIs

Die Entwurfsentscheidungen hinter Schnittstellen.

Definition

Was APIs umfasst

Eine API ist der Vertrag, über den Systeme miteinander sprechen. Diese Kategorie behandelt API-Design, Versionierung und die Wahl zwischen REST, GraphQL und gRPC.

Was diese Kategorie abdeckt

REST vs. GraphQL vs. gRPC
API-Versionierung ohne Brüche
API-Design: Idempotenz, Pagination, Fehler
Zuverlässige Webhooks bauen

Reference Guides

Belastbare Antworten in diesem Feld.

Tiefe, referenzierbare Dokumente — jede Empfehlung mit Trade-off, Kosten und dem Fall, in dem wir anders entscheiden.

Reference Guide · 14 Min.

Idempotenz in verteilten Systemen

Warum verteilte Systeme doppelte Nachrichten ertragen müssen und wie man sie idempotent macht: Idempotency Keys, Retries, Outbox und Inbox.

Reference Guide · 15 Min.

API Design für langlebige Systeme

Wie man APIs entwirft, die Jahre überdauern, ohne die Systeme ihrer Nutzer zu brechen: Verträge, Kompatibilität, Versionierung, Fehler, Evolution.

Reference Guide · 15 Min.

REST, GraphQL oder RPC — die Wahl des API-Stils

Die Wahl des API-Stils nach Passung statt Mode: Was REST, GraphQL und RPC unterscheiden, welche Problemform zu welchem Stil passt, was jeder kostet.

Reference Guide · 13 Min.

API-Versionierung ohne Kunden zu brechen

Wie man eine API über Jahre weiterentwickelt, ohne die Systeme der Kunden zu brechen: kompatibel erweitern, sauber versionieren, Deprecation als Prozess.

Engineering Stories

Gelernte Lektionen in diesem Feld.

Fehler und was sie uns gelehrt haben — anonym, ohne Drama. Der Fehler ist der Lehrer.

Engineering Story · 4 Min.

Schnittstellen überdauern Implementierungen

Eine Engineering Story: Ein externer API-Anbieter wurde ersetzt. Millionen bestehender Datensätze, eine inkompatible neue Struktur — es folgten Abbildung, Migration, Prüfung. Warum die Schnittstelle das Beständige war und die Implementierung dahinter das Vergängliche.

Die Beiträge dieser Kategorie erscheinen fortlaufend. Grundbegriffe finden Sie schon heute im Glossar.

Zum Glossar

Wissensgraph

Setzen Sie Ihren Engineering-Weg fort.

Verwandte Konzepte, Entscheidungen, Playbooks und Standpunkte — als zusammenhängender Pfad, nicht als Linkliste.

Leistungen

Laravel-Entwicklung

Verwandte Konzepte

Idempotenz

Engineering-Entscheidungen

ADR-002: Queue statt synchroner Verarbeitung außerhalb des kritischen Pfads

Playbooks

Eine öffentliche API entwerfen

Ein konkretes Problem in diesem Feld?

Wir lösen es nicht nur auf dem Papier. Sprechen Sie mit den Ingenieuren, die es bauen würden.

Projekt anfragen