API-Vertragstests erklärt: Erkennen Sie wichtige Änderungen, bevor sie versendet werden

  1. Startseite
  2. Blog
  3. Testautomatisierung

Testautomatisierung

API-Vertragstests erklärt: Erfassen Sie wichtige Änderungen, bevor sie versendet werden

Wenn ein Team eine API ändert, kann die App eines anderen Teams bis zur Produktion kaputt gehen, ohne dass es jemand merkt. Beim Vertragstest wird geprüft, ob beide Seiten noch einer Meinung sind, ohne das gesamte System laufen zu lassen. Wir haben fünf realistische API-Änderungen anhand eines Vertrags getestet, um zu zeigen, welche Änderungen den Verbrauchern schaden.

10 Min. Lesezeit
API-Vertragstests erklärt: Erkennen Sie wichtige Änderungen, bevor sie versendet werden

Das Wichtigste

  • Ein Vertrag ist die vereinbarte Form von Anfragen und Antworten zwischen einem API-Anbieter und seinen Verbrauchern.
  • Vertragstests prüfen jede Seite separat anhand dieser Vereinbarung, sodass nicht jeder Dienst ausgeführt werden muss.
  • In unserer Prüfung war das Hinzufügen eines Felds erfolgreich, während das Umbenennen eines Felds, das Ändern eines Typs oder das Hinzufügen eines Aufzählungswerts fehlschlug.
  • Verbraucherorientierte Verträge, oft mit Pact, testen nur, was Verbraucher tatsächlich nutzen.

Das Bestellteam benennt total in amount um, weil es besser lesbar ist. Ihre eigenen Tests werden bestanden und sie werden eingesetzt. Zehn Minuten später zeigt die mobile App an, dass jede Bestellung nichts kostet, und der Rechnungsservice stürzt ab. Jedes Team testete seinen eigenen Code, aber niemand testete die Vereinbarung zwischen ihnen. Diese Lücke wird durch Vertragstests geschlossen.

Wir haben einen kleinen Vertrag als JSON-Schema erstellt und mit der Python-Jsonschema-Bibliothek (Version 4.26) fünf realistische Anbieterantworten darauf überprüft. Die folgenden Ergebnisse stammen aus diesem Lauf. Pact- und OpenAPI-Tools werden in ihrer Dokumentation beschrieben; Wir haben sie für diesen Artikel nicht ausgeführt.

Das Problem beim isolierten Testen von Diensten

In einem System mit vielen Diensten schreibt jedes Team Unit-Tests und API-Tests für seinen eigenen Dienst. Diese Tests nutzen die eigene Vorstellung des Teams davon, was andere Dienste senden und erwarten, oft als Scheintests. Wenn ein Anbieter wechselt, kehren die Mocks des Verbrauchers immer noch in die alte Form zurück, sodass die Tests des Verbrauchers weiterhin bestehen. Die Nichtübereinstimmung wird nur entdeckt, wenn beide Versionen in einer gemeinsamen Umgebung oder in der Produktion aufeinandertreffen. Vollständige End-to-End-Tests können es erkennen, aber sie sind langsam, fragil und erfordern, dass alles zusammen bereitgestellt wird.

Was sind Vertragstests?

Bei Vertragstests wird überprüft, ob zwei Parteien, ein Verbraucher, der eine API aufruft, und ein Anbieter, der sie bereitstellt, sich darüber einig sind, wie sie kommunizieren: Endpunkte, Methoden, Header, Anforderungstexte, Antwortfelder, Typen und Statuscodes. Die Vereinbarung wird als maschinenlesbarer Vertrag niedergeschrieben. Anschließend wird jede Seite einzeln anhand des Vertrags getestet: der Verbraucher anhand eines Modells, das aus dem Vertrag erstellt wurde, und der Anbieter, indem er die Anforderungen des Vertrags anhand des tatsächlichen Dienstes abspielt.

Im Vergleich zu anderen Testarten

Testtyp Schecks Müssen andere Dienste ausgeführt werden?
Unit-Test Interne Logik Nein
API / Funktionstest Das Verhalten eines Dienstes Normalerweise nicht
Vertragstest Vereinbarung zwischen zwei Diensten Nein
Integrationstest Echte Dienste arbeiten zusammen Ja
End-to-End-Test Ganze Benutzerreise Ja, alles

Vertragstests stehen in der Testpyramide zwischen API-Tests und Integrationstests. Sie sind fast so schnell wie Unit-Tests, erkennen aber Probleme, für die zuvor Integrationsumgebungen erforderlich waren.

Eine Vertragsprüfung haben wir durchgeführt

Hier ist ein einfacher Vertrag für eine Bestellantwort, geschrieben als JSON-Schema:

contract = {
  "type": "object",
  "required": ["id", "status", "total"],
  "properties": {
    "id":     {"type": "integer"},
    "status": {"enum": ["paid", "pending", "refunded"]},
    "total":  {"type": "number", "minimum": 0}
  }
}

Wir haben fünf Versionen der Antwort des Anbieters validiert:

v1 provider              PASS
v1 + new field           PASS
renamed total->amount    FAIL: 'total' is a required property
id as string             FAIL: '101' is not of type 'integer'
new status value         FAIL: 'on_hold' is not one of ['paid', 'pending', 'refunded']

Das Hinzufügen eines Felds currency war sicher, da Verbraucher Felder ignorieren, die sie nicht kennen. Das Umbenennen von total, das Senden der ID als Text und die Einführung eines neuen Statuswerts haben den Vertrag gebrochen. Jedes davon hätte die eigenen Tests des Anbieters bestanden.

Breaking vs. sichere Änderungen

Veränderung Normalerweise kaputt?
Fügen Sie ein optionales Antwortfeld hinzu Nein
Fügen Sie einen neuen Endpunkt hinzu Nein
Entfernen Sie ein Antwortfeld oder benennen Sie es um Ja
Ändern Sie den Typ oder das Format eines Feldes Ja
Machen Sie ein optionales Anfragefeld zu einem Pflichtfeld Ja
Fügen Sie einer Antwort einen neuen Enum-Wert hinzu Oftmals, wenn Verbraucher strikt mit Werten umgehen
Statuscodes oder Fehlerformat ändern Ja
Verschärfen Sie die Validierung der Eingaben Oft

Der Enum-Fall ist subtil. Das Hinzufügen von on_hold sieht für den Anbieter harmlos aus, aber ein Verbraucher mit einer switch-Anweisung über bekannte Status kann abstürzen oder nichts anzeigen. Gut geschriebene Verbraucher gehen mit unbekannten Werten elegant um, und Verträge machen diese Erwartung deutlich. Informationen zu Versionierungsstrategien, wenn eine bahnbrechende Änderung unvermeidbar ist, finden Sie unter semantische Versionierung und unsere Best Practices für die REST-API.

Verbraucherorientierte Verträge

Beim verbrauchergesteuerten Vertragstest schreibt jeder Verbraucher genau auf, was er vom Anbieter benötigt: die Anfragen, die er stellt, und die Felder, die er liest. Der Anbieter muss den Vertrag jedes Verbrauchers erfüllen. Das hat einen großen Vorteil: Ein Anbieter kann alles, was kein Verbraucher nutzt, frei ändern oder entfernen und weiß genau, welcher Verbraucher kaputt gehen würde, wenn er etwas ändert, das er nutzt.

Unsere Demo hat ein einzelnes Schema überprüft, das dem anbietergesteuerten Stil näher kommt. Ein echter verbrauchergesteuerter Vertrag würde normalerweise nur die Felder auflisten, die der Verbraucher tatsächlich liest, sodass ein von niemandem verwendetes Feld ohne Fehler entfernt werden könnte.

Tipp: Verträge sollten beschreiben, was ein Verbraucher braucht, und nicht alles, was ein Anbieter zurückgibt. Ein Vertrag, der jedes Feld und jeden genauen Wert fixiert, wird zu einer brüchigen Kopie der Tests des Anbieters, scheitert an harmlosen Änderungen und untergräbt das Vertrauen.

So funktioniert Pact

Pact ist das am weitesten verbreitete verbraucherorientierte Vertragstool mit Bibliotheken für viele Sprachen. Der Fluss aus seiner Dokumentation:

  1. Verbrauchertest: Die Komponententests des Verbrauchers rufen einen Pact-Mock-Server auf und deklarieren jede erwartete Anfrage und die minimale Antwort, die sie benötigen.
  2. Paktdatei: Diese Erwartungen werden als JSON-Vertrag, der „Pakt“, gespeichert.
  3. Teilen: Der Pakt wird auf einem Pact Broker oder PactFlow veröffentlicht.
  4. Anbieterüberprüfung: Das CI des Anbieters ruft alle Pakte ab, spielt jede Anfrage mit dem echten Anbieter ab und prüft die Antworten.
  5. Kann ich bereitstellen? Vor der Bereitstellung auf beiden Seiten wird durch eine Überprüfung bestätigt, dass die Versionen, die zusammen ausgeführt werden sollen, über verifizierte Verträge verfügen.

Anbieterzustände wie „Bestellung 101 vorhanden“ ermöglichen es dem Anbieter, Testdaten für jede Interaktion einzurichten. Hierauf konzentrieren sich die meisten Teams bei der Einführung von Pact.

Anbietergesteuerte Verträge mit OpenAPI

Viele Teams gehen in die andere Richtung: Der Anbieter veröffentlicht eine OpenAPI-Spezifikation und Tests prüfen, ob die echte API mit dieser übereinstimmt und dass Verbraucher nur das verwenden, was darin beschrieben ist. Tools können Live-Antworten anhand der Spezifikation validieren, daraus Tests generieren oder zwei Versionen der Spezifikation vergleichen und bahnbrechende Änderungen kennzeichnen. Dies funktioniert gut für öffentliche APIs mit vielen unbekannten Verbrauchern, bei denen das Sammeln von Verbraucherverträgen unmöglich ist. Der Nachteil besteht darin, dass die Grammatik der Nachrichten überprüft wird und nicht, auf welche Teile sich ein Verbraucher tatsächlich verlässt.

Vertragstests in CI

  • Verbraucherpipeline: Führen Sie Verbrauchervertragstests durch und veröffentlichen Sie den Vertrag bei jeder Änderung.
  • Anbieter-Pipeline: Bei jeder Änderung alle Verbraucherverträge abgleichen; Der Build schlägt bei jeder Pause fehl.
  • Vor der Bereitstellung: Überprüfen Sie die Kompatibilität zwischen den genauen Versionen, die in jeder Umgebung verwendet werden.
  • Webhooks: Wenn ein Verbraucher einen geänderten Vertrag veröffentlicht, lösen Sie sofort die Überprüfung des Anbieters aus.

Wenn man dies in eine CI/CD-Pipeline einfügt, stellt sich die Frage: „Haben wir irgendjemanden kaputt gemacht?“ von einem Meeting in einen Build-Status.

Fallstricke

  • Übermäßige Spezifizierung: Die Behauptung exakter Werte anstelle von Typen und Pflichtfeldern macht Verträge brüchig.
  • Verträge als Funktionstests behandeln: Ein Vertrag prüft Form und Vereinbarung, nicht die geschäftliche Korrektheit. Führen Sie auch Funktionstests durch.
  • Überspringen von Anbieterangaben: Ohne realistische Einrichtungsdaten besteht die Verifizierung aus den falschen Gründen.
  • Kein Eigentum: Jemand muss Eigentümer des Brokers sein und reagieren, wenn Überprüfungen fehlschlagen.
  • Asynchrone Nachrichten vergessen: Ereignisse in Warteschlangen sind ebenfalls Verträge, und Tools wie Pact unterstützen Nachrichtenverträge.

Wann sollten Vertragstests eingesetzt werden?

Vertragstests zahlen sich aus, wenn mehrere Teams Dienste besitzen, die sich gegenseitig aufrufen, die Bereitstellungen unabhängig sind und die Integrationsumgebungen langsam oder unzuverlässig sind. Für ein einzelnes Team mit einer API und einem Frontend, die gemeinsam bereitgestellt werden, können gute API-Tests ausreichend sein. Unser API-Testleitfaden deckt diesen Ausgangspunkt ab.

Beginnen Sie, ohne den Ozean zum Kochen zu bringen

  1. Wählen Sie ein Paar aus: der Verbraucher und der Anbieter, deren Integration am häufigsten bricht oder am wichtigsten ist.
  2. Schreiben Sie die Erwartungen des Verbrauchers für zwei oder drei Schlüsselinteraktionen und bestätigen Sie nur die Felder, die er liest.
  3. Verifizieren Sie den Anbieter vor Ort und korrigieren Sie die Anbieterstatus, bis er aus den richtigen Gründen erfolgreich ist.
  4. Fügen Sie beide Seiten zum CI hinzu, damit jedes Team innerhalb von Minuten erfährt, wenn es gegen die Vereinbarung verstößt.
  5. Bewertung nach ein paar Wochen: Hat es etwas gefangen und ist etwas kaputt gegangen, das es übersehen hat? Dann auf das nächste Paar erweitern.

Wenn Sie klein anfangen, bleibt der Aufwand sichtbar und es entsteht Vertrauen. Teams, die versuchen, jeden Service auf einmal unter Vertrag zu nehmen, bleiben oft bei der Bereitstellung von Werkzeugen und Testdaten stehen, bevor sie einen Nutzen erkennen.

Fazit

Vertragstests erfassen die bahnbrechenden Änderungen, die die eigenen Tests jedes Teams nicht erkennen können: umbenannte Felder, geänderte Typen und neue Enum-Werte. Beginnen Sie mit einem wichtigen Verbraucher-Anbieter-Paar, konzentrieren Sie sich bei Verträgen darauf, was der Verbraucher tatsächlich nutzt, überprüfen Sie den Anbieter in CI und fügen Sie eine Bereitstellungsprüfung hinzu. In unserem einfachen Test hätten drei von fünf plausiblen Änderungen die Verbraucher kaputt gemacht, und das alles unsichtbar für die eigene Suite des Anbieters.

Häufige Fragen

Was ist API-Vertragstest?

Testen, ob ein API-Anbieter und seine Verbraucher sich auf Anforderungs- und Antwortformate einigen, indem jede Seite separat anhand eines gemeinsamen Vertrags geprüft wird, anstatt alle Dienste gemeinsam auszuführen.

Was sind verbraucherorientierte Vertragstests?

Ein Ansatz, bei dem jeder Verbraucher die von ihm gestellten Anforderungen und die benötigten Felder definiert. Der Anbieter wird anhand aller Verbraucherverträge überprüft und weiß daher, welche Änderungen jemanden kaputt machen würden.

Was ist ein Pakt?

Pact ist ein beliebtes Open-Source-Tool für verbraucherorientierte Vertragstests. Verbrauchertests generieren Vertragsdateien, die der Anbieter dann anhand der tatsächlichen Umsetzung überprüft.

Ist das Hinzufügen eines Feldes eine bahnbrechende Änderung?

Das Hinzufügen eines optionalen Antwortfelds ist normalerweise sicher; In unserem Test hat es bestanden. Das Umbenennen, Entfernen oder Ändern des Feldtyps unterbricht die Verbraucher.

Ersetzen Vertragstests End-to-End-Tests?

Es ersetzt viele davon, insbesondere diejenigen, die nur dazu dienen, zu überprüfen, ob Dienste kommunizieren können. Führen Sie einige End-to-End-Tests für kritische Benutzerreisen durch.

Lerne weiter

Arbeiten Sie mit Stack Quora

Benötigen Sie Hilfe beim Testen, WordPress oder SEO?

Wir helfen Teams, bessere Software zu liefern und ihre Websites zu erweitern. Sagen Sie uns, woran Sie gerade arbeiten, und wir schlagen Ihnen einen klaren nächsten Schritt vor.

Lesen Sie weiter

Weitere Anleitungen finden Sie unter Tests, KI und moderne Entwicklung

Hat Ihnen dieser Artikel gefallen? Wählen Sie ein Thema und springen Sie direkt in unsere neuesten Tutorials.

Künstliche Intelligenz

Erklärte RAG-Chunking-Strategien: Fest, Überlappung, Satz, rekursiv und Überschriften, gemessen

RAG-Chunking-Strategien im Vergleich zu einem Dokument mit Tiktoken 0.14: feste Größe, Überlappung, Satzpackung, rekursive Aufteilung und überschrif…

Artikel lesen →
Softwareentwicklung

API-Idempotenz erklärt: Idempotenzschlüssel und sichere Wiederholungsversuche, getestet

Erklärung der API-Idempotenz anhand eines von uns ausgeführten Python-Servers und -Clients: Eine verlorene Antwort verursachte eine doppelte Gebühr …

Artikel lesen →
DevOps

Git Stash erklärt: Speichern, Anwenden, Pop und nicht verfolgte Dateien, getestet

Git Stash erklärt mit Befehlen, die wir auf Git 2.56 ausgeführt haben: Push mit einer Nachricht, nicht verfolgte Dateien, Auflisten und Anzeigen, An…

Artikel lesen →
Softwaretests

Paarweises Testen erklärt: Wie alle Paare 216 Tests auf 13 reduzieren, getestet

Paarweises Testen erklärt mit einem Generator, den wir in Python 3.13 ausgeführt haben: ein Checkout mit 216 Kombinationen, die durch 13 Tests abged…

Artikel lesen →
Testautomatisierung

Test-Doubles erklärt: Dummy, Stub, Spy, Mock und Fake, mit getestetem Python-Code

Test-Doubles werden anhand eines Python-Beispiels erklärt, das in Pytest 9.2 ausgeführt wird: Dummy, Stub, Spy, Mock und Fake, wann jeweils zu verwe…

Artikel lesen →
Datenbanken & SQL

SQL COALESCE erklärt: Standardwerte, NULLIF, IFNULL vs. ISNULL und Traps, getestet

SQL COALESCE wurde mit Abfragen erklärt, die wir in SQLite 3.50 ausgeführt haben: erste Nicht-Null-Werte, leere Zeichenfolgen, NULL in Mathematik, N…

Artikel lesen →
Datenbanken & SQL

SQL Self Join erklärt: Mitarbeiter-Manager, Paare und Zeilenvergleiche, getestet

SQL-Self-Join erklärt anhand von Abfragen, die wir in SQLite 3.50 ausgeführt haben: Mitarbeiter und Manager, mehr verdienen als der Manager, eindeut…

Artikel lesen →
Softwareentwicklung

Erklärter JavaScript-Spread-Operator: Spread vs. Rest, Kopien und Fallstricke, getestet

Der JavaScript-Spread-Operator wird mit Code erklärt, den wir auf Knoten 24 ausgeführt haben: Arrays, Objekte, flache Kopien, Restparameter, das Mat…

Artikel lesen →
Softwareentwicklung

Erklärtes Python-Sammlungsmodul: Counter, defaultdict, deque und mehr, getestet

Python-Sammlungen erklärt mit Code, den wir auf Python 3.13 ausgeführt haben: Counter, defaultdict, deque, benannttuple, OrderedDict und ChainMap, p…

Artikel lesen →
Künstliche Intelligenz

Erklärtes LLM-Kontextfenster: Token, Grenzen und wie man mehr einpasst, gemessen

Das LLM-Kontextfenster wird anhand der Token-Anzahl erklärt, die wir mit Tiktoken gemessen haben: Wörter vs. Token für Prosa, Code und Hindi, Eingab…

Artikel lesen →
Softwareentwicklung

Webhooks erklärt: Wie sie funktionieren und wie man sie sicher empfängt

Webhooks erklärt mit einem Empfänger und Sender, den wir in Python ausgeführt haben: Push vs. Polling, HMAC-SHA256-Signaturen, Ablehnen manipulierte…

Artikel lesen →
DevOps

Git Cherry-Pick erklärt: Kopieren Sie den Commit, den Sie benötigen, sicher und getestet

Git Cherry-Pick erklärt mit Befehlen, die wir in Git 2.56 ausgeführt haben: Kopieren eines Hotfixes in einen Release-Zweig, neue Hashes und Patch-ID…

Artikel lesen →
Testautomatisierung

Snapshot-Tests erklärt: Wie es funktioniert, wann es hilft und wann es weh tut

Snapshot-Tests erklärt anhand einer Pytest- und Sirup-Demo, die wir ausgeführt haben: Snapshots erstellen, Diff nach einer Codeänderung lesen, Zeits…

Artikel lesen →
Softwaretests

Mutationstests erklärt: Warum die 100-prozentige Abdeckung unseren Fehler immer noch übersehen hat

Mutationstests erklärt mit einem kleinen Mutationstool, das wir erstellt und ausgeführt haben: 14 Mutanten, eine Testsuite mit 100 % Linienabdeckung…

Artikel lesen →
Künstliche Intelligenz

Prompt Injection erklärt: Wie KI-Apps ausgetrickst werden und wie man sie verteidigt

Prompt-Injection erklärt für Builder: direkte und indirekte Angriffe, warum Schlüsselwortfilter fehlschlagen (unser Test hat 1 von 4 blockiert) und …

Artikel lesen →
DevOps

Erklärte DNS-Einträge: A, AAAA, CNAME, MX, TXT und TTL mit echten Lookups

DNS-Einträge erklärt anhand der von uns durchgeführten Suchvorgänge: Funktionsweise der Auflösung, A und AAAA, CNAME-Regeln, MX und Null-MX, TXT für…

Artikel lesen →
DevOps

Erklärte Funktionsflags: Sichere Veröffentlichungen, schrittweise Rollouts und Flag-Hygiene

Funktionsflags anhand einer von uns durchgeführten Rollout-Simulation erklärt: Flag-Typen, prozentuale Rollouts mit stabilem Hashing, Kill-Switches,…

Artikel lesen →
Testautomatisierung

Testdatengenerierung mit Python Faker: Realistische, wiederholbare und sichere Daten

Testen Sie die Datengenerierung mit Python Faker, führen Sie sie aus und messen Sie sie: Seeding für wiederholbare Daten, Gebietsschemata, eindeutig…

Artikel lesen →
Softwaretests

Shift-Left-Tests erklärt: Finden Sie Fehler früher, ohne das Team zu verlangsamen

Shift-Left-Tests erklärt: Was es bedeutet, warum Frühdefekte günstiger sind, Vorgehensweisen von Anforderungsüberprüfungen bis hin zu CI-Prüfungen, …

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-String-Funktionen: TRIM, SUBSTR, REPLACE, CONCAT und Datenbereinigung

SQL-String-Funktionen, die mit von uns ausgeführten Abfragen erklärt wurden: Verkettung und NULL, TRIM, UPPER und LOWER, SUBSTR und INSTR, REPLACE, …

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-Trigger: VOR- und NACH-Trigger, Prüfprotokolle und Fallstricke

SQL-Trigger werden anhand von Triggern erklärt, die wir ausgeführt haben: VORHER vs. NACHHER, ALT und NEU, Prüfprotokolle, Validierung, Bestandsaktu…

Artikel lesen →
Softwareentwicklung

Erklärung des Python-JSON-Moduls: Dumps, Loads, benutzerdefinierte Typen und häufige Fehler

Das Python-JSON-Modul wird anhand des von uns ausgeführten Codes erklärt: Dumps und Loads, Dateien, Typkonvertierungen, Datumsangaben und Dezimalzah…

Artikel lesen →
Softwareentwicklung

ES-Module vs. CommonJS: Wie JavaScript-Importe in Node.js funktionieren, getestet

ES-Module vs. CommonJS erklärt mit Code, den wir in Node.js ausgeführt haben: Import- und Exportsyntax, Require, Live-Bindungen, Caching, Top-Level-…

Artikel lesen →
Softwareentwicklung

Python Regex erklärt: Muster, Gruppen, Lookaheads und Fallstricke, getestet

Python-Regex erklärt mit Mustern, die wir ausgeführt haben: Suche vs. Übereinstimmung, Findall, Gruppen und benannte Gruppen, Greedy vs. Lazy, Sub, …

Artikel lesen →
Künstliche Intelligenz

Erklärung der strukturierten LLM-Ausgabe: Zuverlässiges JSON aus KI-Modellen erhalten

Die strukturierte LLM-Ausgabe wird anhand der von uns in Pydantic ausgeführten Validierung erklärt: JSON-Modus und -Schemas, eingeschränkte Dekodier…

Artikel lesen →
DevOps

SSH-Schlüssel erklärt: Wie sie funktionieren, ssh-keygen, Ed25519 und sichere Gewohnheiten

SSH-Schlüssel erklärt mit Schlüsseln, die wir generiert haben: öffentliche vs. private Schlüssel, ssh-keygen, Ed25519 vs. RSA, Fingerabdrücke, Passp…

Artikel lesen →
DevOps

HTTP-Caching erklärt: Cache-Kontrolle, ETag und 304-Antworten, mit einem Live-Test

HTTP-Caching erklärt anhand eines kleinen Servers, den wir ausgeführt haben: Cache-Control-Anweisungen, Max-Age, No-Cache vs. No-Store, ETag-Revalid…

Artikel lesen →
Testautomatisierung

API-Vertragstests erklärt: Erkennen Sie wichtige Änderungen, bevor sie versendet werden

Das Testen von API-Verträgen wird anhand einer von uns durchgeführten Schemaprüfung erklärt: Was ein Vertrag ist, verbrauchergesteuerte Verträge, Pa…

Artikel lesen →
Softwaretests

Risikobasiertes Testen erklärt: Risiken bewerten, eine Matrix erstellen und testen, worauf es ankommt

Risikobasiertes Testen Schritt für Schritt erklärt: Risiken identifizieren, Wahrscheinlichkeit und Auswirkung bewerten, eine Risikomatrix erstellen,…

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-Einschränkungen: NOT NULL, UNIQUE, CHECK und FOREIGN KEY, getestet

SQL-Einschränkungen anhand der von uns durchgeführten Tests erklärt: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY und FOREIGN KEY, die NULL-Lücken, die…

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-Datumsfunktionen: Datumsangaben fehlerfrei hinzufügen, vergleichen und gruppieren

Erklärung der SQL-Datumsfunktionen anhand von Abfragen, die wir ausgeführt haben: Hinzufügen von Intervallen, Überraschungen am Monatsende, Datumsun…

Artikel lesen →
Softwareentwicklung

Python-Asyncio erklärt: Async, Wait, Gather und TaskGroup mit echten Timings

Python-Asyncio erklärt mit Code, den wir getimt haben: Coroutinen, Wait, Gather, TaskGroup, Fehlerbehandlung, Zeitüberschreitungen, Einschränkung de…

Artikel lesen →
Softwareentwicklung

Debounce vs. Throttle in JavaScript: Wie sie funktionieren, wann man sie verwendet, getestet

Debounce vs. Throttle in JavaScript erklärt anhand von Timings, die wir in Node.js gemessen haben: wie jedes funktioniert, einfache Implementierunge…

Artikel lesen →
Softwareentwicklung

Erklärte Python-Kontextmanager: Die with-Anweisung, contextlib und Real Uses

Python-Kontextmanager erklärt anhand des von uns ausgeführten Codes: Funktionsweise, __enter__ und __exit__, contextlib.contextmanager, supprimieren…

Artikel lesen →
Künstliche Intelligenz

LLM-Temperatur und Top-p erklärt: Wie KI-Modelle ihr nächstes Wort wählen

LLM-Temperatur und Top-P erklärt anhand einer von uns durchgeführten Simulation: wie Wahrscheinlichkeiten umgeformt werden, was Top-P beibehält, emp…

Artikel lesen →
DevOps

YAML erklärt: Syntax, das Norwegen-Problem und andere von uns getestete Fallen

YAML erklärt mit einem Parser-Test: grundlegende Syntax, Listen und Karten, das Norwegen-Problem, Versionen, die in Gleitkommazahlen umgewandelt wer…

Artikel lesen →
DevOps

Cron-Jobs erklärt: Syntax, echte Zeitpläne und die Fehler, die sie zerstören

Cron-Jobs werden anhand von Zeitplänen erklärt, die wir überprüft haben: die fünf Felder, Operatoren, reale Beispiele, die Tag-des-Monats- ODER Woch…

Artikel lesen →
Künstliche Intelligenz

KI-Halluzinationen erklärt: Warum Sprachmodelle Dinge erfinden und wie man sie reduziert

KI-Halluzinationen erklärt: Was sie sind, warum Sprachmodelle sie produzieren, gängige Typen, wie man sie mit Erdung und Eingabeaufforderungen reduz…

Artikel lesen →
DevOps

Erklärte Umgebungsvariablen: .env-Dateien, Geheimnisse und Konfiguration richtig gemacht

Umgebungsvariablen anhand von Python-Beispielen erklärt, die wir ausgeführt haben: Sie lesen und festlegen, warum jeder Wert ein String ist, .env-Da…

Artikel lesen →
Softwareentwicklung

API-Ratenbegrenzung erklärt: Algorithmen, Header und Behandlung von 429-Fehlern

API-Ratenbegrenzung anhand einer von uns durchgeführten Simulation erklärt: Token-Bucket, festes Fenster, gleitendes Fenster, 429 Antworten, Ratenbe…

Artikel lesen →
Testautomatisierung

Spott in Python: unittest.mock, Patch und die Fehler, die Tests zum Lügen machen

Mocking in Python mit unittest.mock, getestet: Mock und return_value, side_effect, Patchen, wo ein Name verwendet wird, Spezifikation und Autospec, …

Artikel lesen →
Softwaretests

Code-Abdeckung erklärt: Leitungs- und Zweigstellenabdeckung und was 100 % wirklich bedeutet

Erklärung der Codeabdeckung anhand eines echten Coverage.py-Laufs: Zeilen-, Zweig- und Bedingungsabdeckung, Lesen eines Berichts, warum bei 100 % Ab…

Artikel lesen →
Datenbanken & SQL

DELETE vs. TRUNCATE vs. DROP in SQL: Unterschiede, Rollback und Verwendungszweck

DELETE vs. TRUNCATE vs. DROP erklärt mit getestetem SQL: was jeweils entfernt wird, Rollback, Trigger, Identitätsrücksetzung, Geschwindigkeit und wi…

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-Ansichten: Erstellen, nutzen und vermeiden Sie Fallstricke mit Beispielen

SQL-Ansichten anhand der von uns ausgeführten Abfragen erklärt: Erstellen einer Ansicht, Live-Ergebnisse, Ausblenden von Spalten, Leistung, aktualis…

Artikel lesen →
Softwareentwicklung

TypeScript-Schnittstelle vs. Typ: Echte Unterschiede, getestet mit dem Compiler

TypeScript-Schnittstelle vs. Typ, überprüft mit dem echten Compiler: Was beide können, was nur einer kann, Deklarationszusammenführung, Erweiterunge…

Artikel lesen →
Softwareentwicklung

Python *args und **kwargs erklärt: Flexible Funktionen mit klaren Beispielen

Python *args und **kwargs erklärt mit Code, den wir ausgeführt haben: Packen und Entpacken, Parameterreihenfolge, Nur-Schlüsselwort- und Nur-Positio…

Artikel lesen →
Softwareentwicklung

Python-Lambda-Funktionen: Syntax, tatsächliche Verwendung und wann man sie nicht verwendet

Python-Lambda-Funktionen erklärt mit Code, den wir ausgeführt haben: Syntax, Sortierung mit Schlüssel, Karte und Filter, Abschlüsse, die Late-Bindin…

Artikel lesen →
Künstliche Intelligenz

Was sind KI-Agenten? Wie sie funktionieren, mit einer einfachen Agentenschleife, die Sie ausführen können

Was sind KI-Agenten? Eine einfache Anleitung zur Agentenschleife, zu Tools, Speicher und Leitplanken, mit einer kleinen Python-Schleife, die wir aus…

Artikel lesen →
DevOps

Überwachung vs. Beobachtbarkeit: Der wahre Unterschied, mit Protokollen, Metriken und Traces

Überwachung vs. Beobachtbarkeit erklärt: bekannte und unbekannte Fehler, Protokolle, Metriken und Spuren, eine exemplarische Vorgehensweise für Chec…

Artikel lesen →
DevOps

Docker-Volumes vs. Bind Mounts: Containerdaten auf die richtige Art und Weise beibehalten

Docker-Volumes vs. Bind-Mounts erklärt: Warum Containerdaten verschwinden, benannte Volumes, Bind-Mounts, tmpfs, Compose-Beispiele, Backups, Berecht…

Artikel lesen →
Testautomatisierung

TDD vs. BDD: Hauptunterschiede, eine Funktion, die auf beide Arten entwickelt wurde und wann sie jeweils verwendet werden sollte

TDD vs. BDD erklärt mit einer Rabattfunktion, die in beide Richtungen aufgebaut ist: Rot-Grün-Refaktor mit Code, den wir ausgeführt haben, Gegeben-W…

Artikel lesen →
Softwaretests

Benutzerakzeptanztests (UAT): Prozess, Checkliste und reale Beispiele

Benutzerakzeptanztests erklärt: Wer führt ihn durch, wie unterscheidet er sich von der Qualitätssicherung, ein siebenstufiger Prozess, eine UAT-Test…

Artikel lesen →
Datenbanken & SQL

Erklärte SQL-NULL-Werte: IS NULL, COALESCE, NULLIF und die zu vermeidenden Fallen

SQL-NULL-Werte, die mit von uns ausgeführten Abfragen erklärt wurden: dreiwertige Logik, IS NULL, COALESCE, NULLIF, wie Aggregate, Joins und Sortier…

Artikel lesen →
Datenbanken & SQL

SQL CASE WHEN-Anweisung: Syntax, reale Beispiele und häufige Fehler

SQL CASE WHEN anhand der von uns ausgeführten Abfragen erklärt: einfache und durchsuchte Formulare, Bedingungsreihenfolge, Pivots mit SUM, COUNT-Tri…

Artikel lesen →
Softwareentwicklung

Was ist JWT? JSON-Web-Tokens anhand eines funktionierenden Beispiels erklärt

Was ist JWT? JSON Web Tokens erklärt: die drei Teile, ein Token, das in dem von uns ausgeführten Code erstellt und manipuliert wurde, JWT vs. Sitzun…

Artikel lesen →
Softwareentwicklung

Erklärte JavaScript-Ereignisschleife: Aufrufstapel, Mikrotasks und Timer mit Beispielen

Die JavaScript-Ereignisschleife wurde mit dem von uns ausgeführten Code erklärt: Aufrufstapel, Aufgaben- und Mikrotask-Warteschlangen, warum setTime…

Artikel lesen →
Softwareentwicklung

Erklärung von Python-Generatoren und -Ertrag: Sparen Sie Speicher mit echten Beispielen

Python-Generatoren und Yield anhand des von uns ausgeführten Codes erklärt: wie sie angehalten und fortgesetzt werden, gemessene Speichereinsparunge…

Artikel lesen →
Künstliche Intelligenz

Was sind Einbettungen? Vektoren und Kosinusähnlichkeit einfach erklärt

Was sind Einbettungen? Ein Leitfaden in einfacher Sprache zu Vektoren, Kosinusähnlichkeit und semantischer Suche, mit einem kleinen Beispiel, das wi…

Artikel lesen →
DevOps

Blau-Grün vs. Canary-Bereitstellung: Unterschiede, Kompromisse und Auswahl

Blue-Green vs. Canary-Bereitstellung erklärt: Funktionsweise, Kosten, Risiko und Rollback, stabiles Benutzer-Bucketing, das wir getestet haben, Date…

Artikel lesen →
Testautomatisierung

Flaky-Tests: Was sie verursacht und wie man sie endgültig behebt

Flaky-Tests wurden anhand von Demos erklärt, die wir durchgeführt haben: die Hauptursachen, wie man sie bestätigt und diagnostiziert, richtige Korre…

Artikel lesen →
Softwaretests

Lasttest vs. Stresstest: Unterschiede, Metriken und k6-Beispiele

Erläuterungen zu Lasttests und Stresstests: Was die einzelnen Tests beweisen, Spike- und Soak-Tests, welche Kennzahlen wichtig sind, warum Durchschn…

Artikel lesen →
Softwaretests

Testfall vs. Testszenario: Hauptunterschiede, Beispiele und wann man sie jeweils verwendet

Testfall vs. Testszenario erklärt: klare Definitionen, eine Tabelle nebeneinander, eine Funktion zum Zurücksetzen von Passwörtern, die von Szenarios…

Artikel lesen →
Datenbanken & SQL

SQL-Abfrageoptimierung: Ausführungspläne lesen und langsame Abfragen mit Zeitvorgaben beheben

An einer Million Zeilen getestete SQL-Abfrageoptimierung: Ausführungspläne lesen, die richtigen Indizes hinzufügen, nicht sargierbare Filter korrigi…

Artikel lesen →
Datenbanken & SQL

SQL UNION vs. UNION ALL: Unterschiede, Beispiele und getestete Leistung

SQL UNION vs. UNION ALL anhand der von uns ausgeführten Abfragen erklärt: Duplikate, die Regeln, denen beide folgen, ein echter Datenfehler, gemesse…

Artikel lesen →
Softwareentwicklung

Tutorial zur JavaScript-Abruf-API: GET, POST, Fehlerbehandlung und Zeitüberschreitungen

Ein JavaScript-Abruf-API-Tutorial, das auf einem lokalen Server getestet wurde: GET und POST, warum 404 nicht ausgelöst wird, ein wiederverwendbarer…

Artikel lesen →
Softwareentwicklung

Umgang mit Python-Dateien: Lesen, Schreiben, CSV, JSON und Pathlib mit Beispielen

Die Handhabung von Python-Dateien wird anhand des von uns ausgeführten Codes erklärt: Öffnungsmodi, Lesen großer Dateien, CSV, JSON, Pathlib, Binärd…

Artikel lesen →
Softwareentwicklung

Python-Klassen und -Objekte: OOP-Tutorial mit echten Beispielen

Python-Klassen und -Objekte erklärt mit Code, den wir ausgeführt haben: __init__, Methoden, Klassen- und Instanzattribute, Vererbung, Eigenschaften,…

Artikel lesen →
Künstliche Intelligenz

Was ist ein großes Sprachmodell? Wie LLMs funktionieren, ohne großen Hype erklärt

Was ist ein großes Sprachmodell? LLMs im Klartext erklärt: Token, Einbettungen, Aufmerksamkeit, Training, Temperatur- und Kontextfenster, eine klein…

Artikel lesen →
DevOps

Linux-Befehle für Anfänger: Der grundlegende Terminal-Leitfaden mit Beispielen

Linux-Befehle für Anfänger, gruppiert nach Aufgaben: Navigation, Dateien, Anzeigen von Protokollen, Grep, Pipes, Berechtigungen, Prozesse und Archiv…

Artikel lesen →
Testautomatisierung

Selenium vs. Playwright: Hauptunterschiede, Code im Vergleich und welche Sie wählen sollten

Selenium vs. Playwright im Vergleich: Architektur, Wartezeit, Browser- und Sprachunterstützung, Debugging, der gleiche Test in beiden Tools, Migrati…

Artikel lesen →
Softwaretests

Äquivalenzpartitionierung: Testdesigntechnik anhand von Beispielen erklärt

Erklärung der Äquivalenzpartitionierung: Wie man gültige und ungültige Partitionen findet, Beispiele für Alter, Passwörter und Gutscheine, von uns d…

Artikel lesen →
Softwaretests

Schweregrad vs. Priorität beim Softwaretest: Unterschiede, Matrix und reale Beispiele

Schweregrad vs. Priorität beim Softwaretest erklärt: klare Definitionen, eine Vier-Wege-Matrix mit Beispielen, Stufenskalen, wer die einzelnen Punkt…

Artikel lesen →
Datenbanken & SQL

Tutorial zu SQL-Unterabfragen: Typen, korrelierte Unterabfragen und EXISTS mit Beispielen

Ein SQL-Unterabfrage-Tutorial mit Abfragen, die wir ausgeführt haben: Skalar-, IN-, FROM- und SELECT-Unterabfragen, korrelierte Unterabfragen, EXIST…

Artikel lesen →
Datenbanken & SQL

SQL-Transaktionen und ACID erklärt: COMMIT, ROLLBACK und Isolationsstufen

SQL-Transaktionen und ACID anhand einer von uns durchgeführten Banküberweisung erklärt: COMMIT, ROLLBACK, Sicherungspunkte, Sperren, Isolationsstufe…

Artikel lesen →
Softwareentwicklung

Spickzettel für Git-Befehle: Die Befehle, die Sie tatsächlich verwenden, mit Beispielen

Ein Git-Befehls-Spickzettel, gruppiert nach Aufgabe: Setup, Staging, Branches, Remotes, Stash, Verlauf und Rückgängigmachen von Fehlern, mit Ausgabe…

Artikel lesen →
Softwareentwicklung

Erklärte JavaScript-Versprechen: Dann, Catch, Promise.all und häufige Fehler

JavaScript-Versprechen erklärt mit Code, den wir ausgeführt haben: Zustände, dann und Fangketten, Fehlerbehandlung, Promise.all, allSettled, Rennen …

Artikel lesen →
Softwareentwicklung

Python-Wörterbuch-Tutorial: Methoden, Beispiele und gängige Muster

Ein Python-Wörterbuch-Tutorial mit Code, den wir ausgeführt haben: Diktate erstellen, lesen und aktualisieren, Schlüsselmethoden, Zusammenführung, V…

Artikel lesen →
Künstliche Intelligenz

Was ist RAG? Retrieval-Augmented Generation anhand eines Arbeitsbeispiels erklärt

Was ist RAG? Abruf-erweiterte Generierung Schritt für Schritt erklärt: Indizierung, Chunking, Einbettungen, Abruf, ein kleines funktionierendes Pyth…

Artikel lesen →
DevOps

Terraform-Tutorial für Anfänger: Infrastruktur als Code von der ersten Datei bis zu den Modulen

Ein Terraform-Tutorial für Anfänger: Beginnen Sie ohne Cloud-Konto, lernen Sie Init, Planen und Anwenden, dann Variablen, Ausgaben, Status, Module u…

Artikel lesen →
DevOps

Docker vs. Kubernetes: Hauptunterschiede, wie sie zusammenarbeiten und was Sie brauchen

Docker vs. Kubernetes erklärt: Was jeder tut, die gleiche App läuft mit beiden, Docker Compose und Swarm im Vergleich, die Dockershim-Änderung und w…

Artikel lesen →
Testautomatisierung

Pytest-Tutorial für Anfänger: Vorrichtungen, Parametrisierung und reale Beispiele

Ein Pytest-Tutorial für Anfänger mit Tests, die wir auf Pytest 9.2 durchgeführt haben: Assertions, Fixtures, Parametrize, Conftest, Markers, tmp_pat…

Artikel lesen →
Softwaretests

Software Testing Life Cycle (STLC): 6 Phasen, Einstiegs- und Ausstiegskriterien, Beispiel

Der Softwaretest-Lebenszyklus erklärt: sechs STLC-Phasen mit Ein- und Ausstiegskriterien, Ergebnisse, ein Beispiel für eine funktionierende Anmeldef…

Artikel lesen →
Softwareentwicklung

Git merge vs rebase: Unterschiede, Beispiele und wann man was nutzt

Git merge vs rebase erklärt mit echter Log-Ausgabe, einer Vergleichstabelle, der goldenen Regel des Rebase und einem sicheren Team-Workflow.

Artikel lesen →
Softwareentwicklung

Python List Comprehension: Syntax, Beispiele und wann man darauf verzichtet

Python List Comprehension erklärt: Syntax, Filter, if-else, verschachtelte Schleifen, gemessene Zeiten und Fälle, in denen eine normale for-Schleife…

Artikel lesen →
Datenbanken & SQL

SQL Joins erklärt mit Beispielen (Inner, Left, Right, Full)

SQL Joins Schritt für Schritt mit Beispieltabellen und Abfragen verstehen: INNER, LEFT, RIGHT, FULL, CROSS und SELF, plus typische Fehler und Perfor…

Artikel lesen →