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

  1. Startseite
  2. Blog
  3. Softwareentwicklung

Softwareentwicklung

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

API-Idempotenz bedeutet, dass das zweimalige Senden derselben Anfrage die gleiche Wirkung hat wie das einmalige Senden. Erfahren Sie mit einer Python-Demo, die aus einer doppelten Ladung eine einzige macht, welche HTTP-Methoden idempotent sind, warum POST einen Idempotenzschlüssel benötigt und wie man einen sicher erstellt.

9 Min. Lesezeit
API-Idempotenz erklärt: Idempotenzschlüssel und sichere Wiederholungsversuche

Das Wichtigste

  • API-Idempotenz bedeutet, dass die Wiederholung einer Anfrage ihren Nebeneffekt nicht wiederholt. GET, PUT und DELETE sind per Definition idempotent; POST ist nicht.
  • In unserer Demo führte eine verlorene Antwort, gefolgt von einem erneuten Versuch, zu zwei Ladungen ohne Schlüssel und einer mit einer Idempotency-Key.
  • Speichern Sie einen Fingerabdruck des Anforderungstexts mit dem Schlüssel: Die Wiederverwendung eines Schlüssels mit einem anderen Textkörper ergab 422 auf unserem Server.
  • Beanspruchen Sie den Schlüssel atomar. Zwei gleichzeitige Wiederholungsversuche ergaben 201 und 409, und es wurde nur eine Gebühr erhoben.

Netzwerke fallen am schlimmsten Ort aus: nachdem der Server die Arbeit erledigt hat, aber bevor der Client eine Antwort erhält. Der Kunde sieht eine Zeitüberschreitung, versucht es noch einmal und dem Kunden wird doppelt in Rechnung gestellt oder eine Bestellung wird zweimal versendet. API-Idempotenz ist die Designregel, die diese Wiederholungsversuche sicher macht, und Idempotenzschlüssel sind die Standardmethode, um sie auf Anfragen anzuwenden, die Dinge erstellen.

Um das Problem aufzuzeigen und nicht zu beschreiben, haben wir eine kleine Zahlungs-API mit dem integrierten HTTP-Server von Python 3.13 und einem Client geschrieben, der es nach einer unterbrochenen Verbindung erneut versucht. Alles lief lokal und die folgenden Ausgaben werden von diesem Lauf kopiert. Echte Zahlungsanbieter bieten noch viel mehr. Behandeln Sie den Code daher als Lehrmodell. Informationen zum allgemeinen API-Design finden Sie in unseren Best Practices für die REST-API.

Was ist Idempotenz?

Eine Operation ist idempotent, wenn sie einmal oder mehrmals ausgeführt wird und das System im gleichen Zustand verbleibt. Das Einstellen eines Lichtschalters auf „Aus“ ist idempotent: Durch fünfmaliges Drücken von „Aus“ bleibt er immer noch ausgeschaltet. Das Umschalten des Schalters ist nicht möglich, da sich bei jedem Drücken das Ergebnis ändert.

Beachten Sie, dass es bei Idempotenz um die Auswirkung auf den Server geht, nicht um die Antwort. Das zweimalige Löschen einer Bestellung ist idempotent, auch wenn der zweite Aufruf 404 zurückgibt, da die Bestellung in beide Richtungen gelöscht wurde. Ein verwandtes Wort, sicher, bedeutet, dass die Anfrage überhaupt nichts ändert, wie GET.

Welche HTTP-Methoden sind idempotent?

Die HTTP-Spezifikation RFC 9110 definiert diese Eigenschaften für jede Methode:

Methode Sicher Idempotent Typische Verwendung
GET, HEAD, OPTIONEN Ja Ja Daten lesen
SETZEN Nein Ja Ersetzen Sie eine Ressource unter einer bekannten URL
LÖSCHEN Nein Ja Entfernen Sie eine Ressource
POST Nein Nein Erstellen Sie eine Ressource oder lösen Sie eine Aktion aus
PATCH Nein Nicht garantiert Teilweise Aktualisierung

Die Tabelle beschreibt, was Server tun sollten. Ein schlecht gestalteter PUT, der einen Zähler erhöht, bricht das Versprechen. Und PATCH hängt von der Nutzlast ab: „Menge auf 3 setzen“ ist idempotent, „1 zur Menge hinzufügen“ hingegen nicht. Unser Spickzettel für HTTP-Statuscodes listet die Antworten auf, die jede Methode normalerweise zurückgibt.

Das Wiederholungsproblem

Ein Client sendet POST /payments. Drei Dinge können passieren:

  1. Die Anfrage erreicht nie den Server. Ein erneuter Versuch ist sicher.
  2. Der Server verarbeitet es und die Antwort kommt. Es ist kein erneuter Versuch erforderlich.
  3. Der Server verarbeitet es, aber die Antwort geht aufgrund einer Zeitüberschreitung oder einer unterbrochenen Verbindung verloren. Der Kunde kann dies nicht von Fall 1 unterscheiden.

Fall 3 ist der gefährliche. Wenn der Client es erneut versucht, erstellt der Server eine zweite Zahlung. Wenn kein erneuter Versuch unternommen wird, wird eine Zahlung, die in Fall 1 fehlgeschlagen ist, nie ausgeführt. Ohne die Hilfe des Servers hat der Client keine sichere Wahl.

Wie Idempotenzschlüssel funktionieren

Die Lösung besteht darin, jeder logischen Operation eine eindeutige ID zu geben, die sich der Server merkt:

  1. Der Client generiert einen zufälligen Schlüssel, normalerweise eine UUID, und sendet ihn in einem Header wie Idempotency-Key.
  2. Der Server prüft, ob er den Schlüssel gesehen hat. Wenn nicht, zeichnet es den Schlüssel auf, erledigt die Arbeit und speichert die Antwort mit dem Schlüssel.
  3. Wenn derselbe Schlüssel erneut eintrifft, überspringt der Server die Arbeit und gibt die gespeicherte Antwort zurück.
  4. Schlüssel verfallen nach einem Aufbewahrungszeitraum, der in der Regel etwa 24 Stunden beträgt, obwohl dies je nach Anbieter unterschiedlich ist.

Zahlungsanbieter haben das Muster populär gemacht und ein IETF-Standardentwurf beschreibt den Idempotency-Key-Header für HTTP-APIs im Allgemeinen.

Unser Demoserver

Das Herzstück des Servers sind ein paar Zeilen, die den Schlüssel beanspruchen und dann entweder die Arbeit erledigen oder das gespeicherte Ergebnis wiedergeben:

key = self.headers.get("Idempotency-Key")
fp = hashlib.sha256(body).hexdigest()          # fingerprint of the request
if key:
    with lock:                                  # atomic claim
        rec = keys.get(key)
        if rec is None:
            keys[key] = {"fp": fp, "state": "processing"}
    if rec:
        if rec["fp"] != fp:
            return self.reply(422, {"error": "key reused with different body"})
        if rec["state"] == "processing":
            return self.reply(409, {"error": "request in progress"})
        return self.reply(rec["status"], rec["body"], replay=True)

charges.append(data["amount"])                  # the side effect
out = {"charge_id": f"ch_{len(charges)}", "amount": data["amount"]}
if key:
    keys[key].update(state="done", status=201, body=out)

Um Fall 3 zu simulieren, kann der Server angewiesen werden, den Ladevorgang abzuschließen und dann die Verbindung zu schließen, ohne zu antworten. Der Client sieht einen Fehler und versucht es erneut mit der identischen Anfrage.

Ergebnisse: mit und ohne Schlüssel

no key, attempt 1: ('ERR', 'RemoteDisconnected', None)
no key, retry:     (201, {'charge_id': 'ch_2', 'amount': 500}, None)
charges without key: [500, 500]

key, attempt 1:    ('ERR', 'RemoteDisconnected', None)
key, retry:        (201, {'charge_id': 'ch_1', 'amount': 500}, 'true')
charges with key:  [500]

Ohne Schlüssel wurden dem Kunden zweimal 500 berechnet, und der Kunde sah immer nur die Gebühr ch_2; Die erste Ladung wurde unsichtbar. Mit einem Schlüssel erhielt der Wiederholungsversuch die ursprüngliche Antwort ch_1 mit einem Idempotent-Replayed: true-Header, und es ist nur eine Gebühr vorhanden. Der Kunde erhielt genau die Antwort, die er beim ersten Mal verpasst hatte.

Tipp: Wiederholen Sie die gespeicherte Antwort, einschließlich des Statuscodes. Die Rückgabe einer anderen Nachricht wie „doppelte Anfrage“ zwingt jeden Client dazu, eine spezielle Behandlung zu schreiben, und macht den Punkt zunichte.

Wiederverwendung eines Schlüssels mit einem anderen Körper

Ein Schlüssel sollte einen Vorgang identifizieren. Wenn ein Kunde versehentlich denselben Schlüssel mit einem anderen Betrag sendet, wäre das erneute Abspielen der alten Antwort falsch und würde auch den neuen Betrag berechnen. Unser Server speichert einen SHA-256-Fingerabdruck des Körpers mit dem Schlüssel und vergleicht ihn:

same key same body:      201 (replayed)
same key different body: (422, {'error': 'key reused with different body'})

Eine lautstarke Ablehnung verwandelt einen stillen Client-Fehler in einen offensichtlichen. Die Anbieter unterscheiden sich hinsichtlich des genauen Statuscodes. Der IETF-Entwurf schlägt für diesen Fall 422 vor.

Gleichzeitige Wiederholungsversuche

Aggressive Clients versuchen es manchmal noch einmal, bevor der erste Versuch abgeschlossen ist. Wenn der Server den Schlüssel prüft und ihn dann in zwei separaten Schritten einfügt, können beide Anfragen die Prüfung bestehen und beide können eine Gebühr erheben. Wir haben zwei identische Anfragen mit demselben Schlüssel gleichzeitig gesendet, wobei die Arbeit eine halbe Sekunde dauerte:

concurrent same key: [201, 409] charges: [700]

Ein Antrag gewann den Atomanspruch und wurde angeklagt; Der andere sah den Schlüssel im Status processing und erhielt den Fehler 409 Conflict, der den Client anweist, zu warten und es erneut zu versuchen. In der Produktion wird die Sperre durch eine Eindeutigkeitsbeschränkung der Datenbank oder eine atomare Operation „Einfügen bei Abwesenheit“ wie Redis SET NX ersetzt, sodass sie auf vielen Servern funktioniert.

Checkliste für das Serverdesign

  • Bereichsschlüssel für das Konto oder den API-Schlüssel, damit zwei Kunden nicht kollidieren können.
  • Anspruch vor der Arbeit, atomar, und einen processing Zustand aufzeichnen.
  • Speichern Sie die vollständige Antwort, den Status und den Text, wenn die Arbeit abgeschlossen ist.
  • Fingerabdruck der Anfrage und nicht übereinstimmende Wiederverwendung ablehnen.
  • Behandeln Sie Fehler bewusst. Wenn die Arbeit aufgrund eines Serverfehlers fehlschlägt, lassen Sie die Taste los, damit ein erneuter Versuch erfolgen kann. Wenn die Validierung fehlschlägt, speichern Sie den Fehler und geben Sie ihn erneut ab.
  • Lässt Schlüssel nach einem dokumentierten Zeitfenster ab und behalte den Nebeneffekt und den Schlüsseldatensatz nach Möglichkeit in derselben Transaktion.
  • Machen Sie auch interne Schritte idempotent. Nachrichtenkonsumenten und Webhook-Handler erhalten Duplikate, also deduplizieren Sie sie auf einer Ereignis-ID.

Clientseitige Regeln

  • Generieren Sie einen Schlüssel pro logischer Operation, nicht pro HTTP-Versuch, und verwenden Sie ihn für jeden Wiederholungsversuch dieser Operation wieder.
  • Versuchen Sie es nur bei Netzwerkfehlern, Zeitüberschreitungen, 409-, 429- und 5xx-Antworten mit exponentiellem Backoff und Jitter. Unser Leitfaden zur API-Ratenbegrenzung erklärt Backoff.
  • Versuchen Sie niemals, einen 4xx-Validierungsfehler unverändert zu wiederholen. es wird auf die gleiche Weise scheitern.
  • Behalten Sie den Schlüssel mit dem ausstehenden Vorgang bei, damit eine neu gestartete App den Vorgang sicher wiederholen kann.

So testen Sie Idempotenz

Idempotenzfehler bleiben verborgen, bis der Produktionsverkehr chaotisch ist. Testen Sie sie also absichtlich. Senden Sie dieselbe Anfrage zweimal und stellen Sie sicher, dass eine Ressource vorhanden ist. Senden Sie denselben Schlüssel mit einem anderen Textkörper und bestätigen Sie den Fehler. Lösen Sie parallele Anfragen mit einem Schlüssel aus und behaupten Sie einen einzelnen Nebeneffekt, wie es unser gleichzeitiger Test tat. Trennen Sie die Verbindung, nachdem der Server ein Commit durchgeführt hat, mithilfe eines Proxys oder eines Test-Hooks und prüfen Sie, ob beim erneuten Versuch die ursprüngliche Antwort erhalten wird. Diese Prüfungen passen natürlich in API-Tests, die mit den Tools in unserem API-Test mit Postman-Leitfaden erstellt wurden.

Fazit

Durch die API-Idempotenz werden Wiederholungsversuche von einem Risiko zur Routine. Verwenden Sie natürlich idempotente Methoden, wo sie passen, und geben Sie jedem POST, der Geld bewegt oder wichtige Datensätze erstellt, einen Idempotenzschlüssel. Fordern Sie auf dem Server Schlüssel atomar an, speichern und geben Sie vollständige Antworten wieder und lehnen Sie die Wiederverwendung mit einem anderen Körper ab. Unsere kleine Demo zeigte den Unterschied in einer Zeile: Aus zwei Ladungen wurde eine.

Häufige Fragen

Was ist Idempotenz in einer API?

Ein API-Vorgang ist idempotent, wenn das mehrmalige Senden derselben Anforderung die gleiche Auswirkung auf den Server hat wie das einmalige Senden, sodass Clients es sicher erneut versuchen können.

Ist POST idempotent?

Nein. POST erstellt normalerweise eine neue Ressource oder löst jedes Mal eine Aktion aus. Fügen Sie einen Idempotenzschlüssel hinzu, damit der Server wiederholte Versuche erkennen und sicher ignorieren kann.

Was ist ein Idempotenzschlüssel?

Dabei handelt es sich um einen eindeutigen Wert, häufig eine UUID, den der Client mit einer Anfrage sendet. Der Server speichert das Ergebnis unter diesem Schlüssel und gibt dasselbe Ergebnis zurück, wenn der Schlüssel erneut angezeigt wird.

Wie lange sollten Idempotenzschlüssel gespeichert werden?

Lang genug, um jeden realistischen Wiederholungsversuch abzudecken. Etwa 24 Stunden sind üblich, die Anbieter unterscheiden sich jedoch. Dokumentieren Sie daher Ihr Fenster und verfallen Sie alte Schlüssel.

Was sollte der Server bei einer doppelten Anfrage zurückgeben?

Geben Sie die gespeicherte Originalantwort mit demselben Statuscode und Text zurück. Wenn das Original noch läuft, geben Sie 409 zurück, damit der Client es später erneut versucht.

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 →