API-identiteit uitgelegd: Idempotentiesleutels en veilige nieuwe pogingen, getest

  1. Home
  2. Blog
  3. Softwareontwikkeling

Softwareontwikkeling

API-identiteit uitgelegd: Idempotentiesleutels en veilige nieuwe pogingen, getest

API-idempotentie betekent dat het tweemaal verzenden van hetzelfde verzoek hetzelfde effect heeft als het eenmaal verzenden ervan. Ontdek welke HTTP-methoden idempotent zijn, waarom POST een idempotency-sleutel nodig heeft en hoe u er veilig een kunt bouwen, met een Python-demo die een dubbele kosten in één enkele kosten omzet.

9 min leestijd
API-idempotentie uitgelegd: idempotentiesleutels en veilige nieuwe pogingen

Belangrijkste punten

  • API-idempotentie betekent dat het herhalen van een verzoek het neveneffect ervan niet herhaalt. GET, PUT en DELETE zijn per definitie idempotent; POST is dat niet.
  • In onze demo leidde een verloren reactie gevolgd door een nieuwe poging tot twee afschrijvingen zonder sleutel en één met een Idempotency-Key.
  • Bewaar een vingerafdruk van de verzoekinstantie met de sleutel: het hergebruiken van een sleutel met een andere instantie retourneert 422 op onze server.
  • Claim de sleutel atomair. Twee gelijktijdige nieuwe pogingen leverden 201 en 409 op, en er werd slechts één aanklacht ingediend.

Netwerken falen op de slechtst mogelijke plaatsen: nadat de server het werk heeft gedaan, maar voordat de client iets terughoort. De klant ziet een time-out, nieuwe pogingen en een klant betaalt twee keer of een bestelling wordt twee keer verzonden. API-idempotentie is de ontwerpregel die deze nieuwe pogingen veilig maakt, en idempotentiesleutels zijn de standaardmanier om deze toe te passen op verzoeken die dingen creëren.

Om het probleem te laten zien in plaats van het te beschrijven, hebben we een kleine betalings-API geschreven met de ingebouwde HTTP-server van Python 3.13 en een client die het opnieuw probeert nadat de verbinding is verbroken. Alles is lokaal uitgevoerd en de onderstaande uitvoer is uit die run gekopieerd. Echte betalingsproviders voegen nog veel meer toe, dus behandel de code als een leermodel. Zie onze best practices voor REST API voor algemeen API-ontwerp.

Wat is idempotentie?

Een bewerking is idempotent als het systeem één of meerdere keren wordt uitgevoerd en het systeem in dezelfde staat blijft. Een lichtschakelaar op ‘uit’ zetten is idempotent: als je vijf keer op ‘uit’ drukt, blijft hij nog steeds uit. Het omschakelen van de schakelaar is dat niet, omdat elke druk op de knop het resultaat verandert.

Houd er rekening mee dat idempotentie gaat over het effect op de server, niet over de reactie. Het tweemaal verwijderen van een bestelling is idempotent, zelfs als de tweede oproep 404 retourneert, omdat de bestelling hoe dan ook verdwenen is. Een verwant woord, veilig, betekent dat het verzoek helemaal niets verandert, zoals GET.

Welke HTTP-methoden zijn idempotent?

De HTTP-specificatie, RFC 9110, definieert deze eigenschappen voor elke methode:

Methode Veilig Idempotent Typisch gebruik
KRIJG, HOOFD, OPTIES Ja Ja Gegevens lezen
ZET Nee Ja Vervang een bron op een bekende URL
VERWIJDEREN Nee Ja Een hulpbron verwijderen
POST Nee Nee Maak een bron aan of activeer een actie
PATCH Nee Niet gegarandeerd Gedeeltelijke update

In de tabel wordt beschreven wat servers moeten doen. Een slecht ontworpen PUT die een teller verhoogt, breekt de belofte. En PATCH is afhankelijk van de payload: “stel de hoeveelheid in op 3” is idempotent, terwijl “1 toevoegen aan de hoeveelheid” dat niet is. Ons spiekbriefje voor HTTP-statuscodes vermeldt de antwoorden die elke methode gewoonlijk retourneert.

Het probleem met opnieuw proberen

Een klant stuurt POST /payments. Er kunnen drie dingen gebeuren:

  1. Het verzoek bereikt nooit de server. Opnieuw proberen is veilig.
  2. De server verwerkt het en het antwoord arriveert. Er is geen nieuwe poging nodig.
  3. De server verwerkt het, maar het antwoord gaat verloren door een time-out of verbroken verbinding. Behalve in geval 1 kan de cliënt dit niet vertellen.

Geval 3 is het gevaarlijke. Als de klant het opnieuw probeert, maakt de server een tweede betaling aan. Als er geen nieuwe poging wordt gedaan, wordt een betaling die in geval 1 mislukte, nooit uitgevoerd. Zonder hulp van de server heeft de client geen veilige keuze.

Hoe idempotentiesleutels werken

De oplossing is om elke logische bewerking een unieke ID te geven die de server onthoudt:

  1. De client genereert een willekeurige sleutel, meestal een UUID, en verzendt deze in een header zoals Idempotency-Key.
  2. De server controleert of hij de sleutel heeft gezien. Als dat niet het geval is, registreert het de sleutel, doet het werk en slaat het antwoord op bij de sleutel.
  3. Als dezelfde sleutel opnieuw arriveert, slaat de server het werk over en retourneert het opgeslagen antwoord.
  4. Sleutels verlopen na een bewaarperiode, meestal ongeveer 24 uur, hoewel dit per provider verschilt.

Betalingsproviders hebben het patroon gepopulariseerd, en een IETF-conceptstandaard beschrijft de Idempotency-Key header voor HTTP API’s in het algemeen.

Onze demoserver

Het hart van de server bestaat uit een paar regels die de sleutel claimen en vervolgens het werk doen of het opgeslagen resultaat opnieuw afspelen:

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)

Om geval 3 te simuleren, kan de server worden opgedragen het opladen te voltooien en vervolgens de verbinding te verbreken zonder te antwoorden. De client ziet een fout en probeert het opnieuw met hetzelfde verzoek.

Resultaten: met en zonder sleutel

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]

Zonder sleutel werd de klant tweemaal 500 in rekening gebracht, en de klant zag alleen maar afschrijving ch_2; de eerste aanval werd onzichtbaar. Met een sleutel ontving de nieuwe poging het oorspronkelijke antwoord, ch_1, met een Idempotent-Replayed: true header, en er is slechts één afschrijving. De klant kreeg precies het antwoord dat hij de eerste keer had gemist.

Tip: speel het opgeslagen antwoord opnieuw af, inclusief de statuscode. Als u een ander bericht retourneert, zoals ‘dubbel verzoek’, wordt elke klant gedwongen een speciale behandeling te schrijven, wat het punt teniet doet.

Een sleutel hergebruiken met een andere body

Een sleutel moet één handeling identificeren. Als een klant per ongeluk dezelfde sleutel met een ander bedrag verzendt, is het opnieuw afspelen van het oude antwoord verkeerd, evenals het in rekening brengen van het nieuwe bedrag. Onze server slaat een SHA-256-vingerafdruk van het lichaam met de sleutel op en vergelijkt deze:

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

Door luid te weigeren wordt een stille clientbug een voor de hand liggende bug. Aanbieders verschillen van mening over de exacte statuscode; het IETF-ontwerp suggereert 422 voor dit geval.

Gelijktijdige nieuwe pogingen

Agressieve clients proberen het soms opnieuw voordat de eerste poging is voltooid. Als de server de sleutel controleert en deze vervolgens in twee afzonderlijke stappen invoegt, kunnen beide verzoeken de controle doorstaan ​​en kunnen beide in rekening worden gebracht. We hebben op hetzelfde moment twee identieke verzoeken met dezelfde sleutel verzonden, waarbij het werk een halve seconde in beslag nam:

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

Eén verzoek won de atoomclaim en werd in rekening gebracht; de ander zag de sleutel in de staat processing en kreeg 409 Conflict, wat de cliënt vertelt om te wachten en het opnieuw te proberen. In productie wordt de vergrendeling vervangen door een database-unieke beperking of een atomaire ‘insert if afwezig’-operatie zoals Redis SET NX, zodat het op veel servers werkt.

Controlelijst voor serverontwerp

  • Scopesleutels voor het account of de API-sleutel, zodat twee klanten niet met elkaar in botsing kunnen komen.
  • Claim voordat je gaat werken, atomair, en leg een processing status vast.
  • Sla het volledige antwoord op, de status en de hoofdtekst, wanneer het werk klaar is.
  • Maak een vingerafdruk van het verzoek en wijs niet-overeenkomend hergebruik af.
  • Ga bewust om met fouten. Als het werk mislukt vanwege een serverfout, laat dan de sleutel los zodat je het opnieuw kunt proberen; als de validatie mislukt, slaat u de fout op en speelt u deze opnieuw af.
  • Verloopt sleutels na een gedocumenteerde periode en bewaar de bijwerking en de sleutelrecord waar mogelijk in dezelfde transactie.
  • Maak ook de interne stappen idempotent. Berichtconsumenten en webhook handlers ontvangen duplicaten, dus ontdubbel de gebeurtenis-ID.

Regels aan de klantzijde

  • Genereer één sleutel per logische bewerking, niet per HTTP-poging, en gebruik deze opnieuw voor elke nieuwe poging van die bewerking.
  • Probeer het alleen opnieuw bij netwerkfouten, time-outs, 409-, 429- en 5xx-reacties, met exponentiële vertraging en jitter. In onze gids voor API-snelheidsbeperkingen wordt uitgelegd hoe u dit kunt doen.
  • Probeer nooit opnieuw een 4xx-validatiefout onveranderd; het zal op dezelfde manier mislukken.
  • Houd de sleutel vast terwijl de bewerking in behandeling is, zodat een opnieuw opgestarte app het veilig opnieuw kan proberen.

Hoe idempotentie te testen

Idempotency-bugs verbergen zich totdat het productieverkeer rommelig wordt, dus test ze met opzet. Verzend hetzelfde verzoek tweemaal en beweer dat er één bron bestaat. Stuur dezelfde sleutel met een andere body en bevestig de fout. Vuur parallelle verzoeken af ​​met één sleutel en claim een ​​enkel neveneffect, zoals onze gelijktijdige test deed. Verbreek de verbinding nadat de server een commit heeft gemaakt, met behulp van een proxy of een testhook, en controleer of de nieuwe poging het oorspronkelijke antwoord oplevert. Deze controles passen op natuurlijke wijze in API-tests die zijn gebouwd met de tools in onze API-testen met Postman-handleiding.

Tot slot

API-idempotentie verandert nieuwe pogingen van een risico in een routine. Gebruik natuurlijk idempotente methoden waar ze passen, en geef elke POST die geld verplaatst of belangrijke documenten creëert een idempotency-sleutel. Op de server kunt u sleutels atomair claimen, volledige antwoorden opslaan en opnieuw afspelen, en hergebruik met een andere instantie afwijzen. Onze kleine demo liet het verschil in één regel zien: twee kosten werden één.

Veelgestelde vragen

Wat is idempotentie in een API?

Een API-bewerking is idempotent wanneer het meerdere keren doen van hetzelfde verzoek hetzelfde effect heeft op de server als het één keer doen, zodat clients het veilig opnieuw kunnen proberen.

Is POST idempotent?

Nee. POST creëert meestal een nieuwe bron of activeert elke keer een actie. Voeg een idempotency-sleutel toe, zodat de server herhaalde pogingen kan herkennen en veilig kan negeren.

Wat is een idempotentiesleutel?

Het is een unieke waarde, vaak een UUID, die de client meestuurt bij een verzoek. De server slaat het resultaat op onder die sleutel en retourneert hetzelfde resultaat als de sleutel opnieuw wordt gezien.

Hoe lang moeten idempotentiesleutels worden bewaard?

Lang genoeg om elke realistische nieuwe poging te dekken. Ongeveer 24 uur is gebruikelijk, maar providers verschillen, dus documenteer uw periode en laat oude sleutels verlopen.

Wat moet de server retourneren bij een duplicaatverzoek?

Retourneer het opgeslagen originele antwoord met dezelfde statuscode en hoofdtekst. Als het origineel nog steeds actief is, retourneert u 409 zodat de client het later opnieuw probeert.

Blijf leren

Werk met Stack Quora

Hulp nodig met testen, WordPress of SEO?

We helpen teams betere software te leveren en hun sites te laten groeien. Vertel ons waar u mee bezig bent en wij stellen een duidelijke volgende stap voor.

Blijf lezen

Meer handleidingen over testen, AI en moderne ontwikkeling

Genoten van dit artikel? Kies een onderwerp en ga direct naar onze nieuwste tutorials.

Kunstmatige intelligentie

RAG-chunkingstrategieën uitgelegd: vast, overlap, zin, recursief en koppen, gemeten

RAG-chunkingstrategieën vergeleken op één document met tiktoken 0.14: vaste grootte, overlap, zinsverpakking, recursieve splitsing en op kop gebasee…

Lees artikel →
Softwareontwikkeling

API-identiteit uitgelegd: Idempotentiesleutels en veilige nieuwe pogingen, getest

API-idempotentie uitgelegd met een Python-server en -client die we hebben uitgevoerd: een verloren reactie veroorzaakte een dubbele afschrijving zon…

Lees artikel →
DevOps

Git Stash uitgelegd: bestanden opslaan, toepassen, pop-uppen en niet-bijgehouden, getest

Git stash uitgelegd met commando's die we uitvoerden op Git 2.56: push met een bericht, niet-bijgehouden bestanden, lijst en show, apply vs pop, beh…

Lees artikel →
Softwaretesten

Paarsgewijze testen uitgelegd: hoe All-Pairs 216 tests terugbrengt naar 13, getest

Paarsgewijs testen uitgelegd met een generator die we in Python 3.13 draaiden: een checkout met 216 combinaties gedekt door 13 tests, geverifieerde …

Lees artikel →
Testautomatisering

Testdubbels uitgelegd: Dummy, Stub, Spy, Mock en Fake, met geteste Python-code

Testdubbels uitgelegd met één Python-voorbeeld uitgevoerd in pytest 9.2: dummy, stub, spion, mock en fake, wanneer je ze moet gebruiken, status- ver…

Lees artikel →
Databases & SQL

SQL COALESCE uitgelegd: standaardwaarden, NULLIF, IFNULL versus ISNULL en traps, getest

SQL COALESCE uitgelegd met query's die we in SQLite 3.50 uitvoerden: eerste niet-null-waarden, lege tekenreeksen, NULL in wiskunde, NULLIF voor dele…

Lees artikel →
Databases & SQL

SQL Self Join uitgelegd: medewerker-manager, paren- en rijvergelijkingen, getest

SQL self-join uitgelegd met vragen die we in SQLite 3.50 uitvoerden: werknemer en manager, meer verdienen dan de manager, unieke paren, dagelijkse v…

Lees artikel →
Softwareontwikkeling

JavaScript Spread Operator uitgelegd: Spread versus rest, kopieën en valkuilen, getest

De JavaScript-spreadoperator legde uit met code die we op knooppunt 24 uitvoerden: arrays, objecten, ondiepe kopieën, restparameters, de Math.max-li…

Lees artikel →
Softwareontwikkeling

Python Collections-module uitgelegd: Counter, defaultdict, deque en meer, getest

Python-collecties uitgelegd met code die we draaiden op Python 3.13: Counter, defaultdict, deque, genaamdtuple, OrderedDict en ChainMap, plus een li…

Lees artikel →
Kunstmatige intelligentie

LLM-contextvenster uitgelegd: tokens, limieten en hoe u meer kunt passen, gemeten

Het LLM-contextvenster uitgelegd met tokenaantallen die we hebben gemeten met tiktoken: woorden versus tokens voor proza, code en Hindi, input- en o…

Lees artikel →
Softwareontwikkeling

Webhooks uitgelegd: hoe ze werken en hoe u ze veilig kunt ontvangen

Webhooks uitgelegd met een ontvanger en afzender die we in Python draaiden: push versus polling, HMAC-SHA256-handtekeningen, het weigeren van geknoe…

Lees artikel →
DevOps

Git Cherry-Pick uitgelegd: kopieer de commit die je nodig hebt, veilig, getest

Git cherry-pick uitgelegd met commando's die we in Git 2.56 uitvoerden: een hotfix kopiëren naar een release branch, nieuwe hashes en patch-ids, -x,…

Lees artikel →
Testautomatisering

Momentopnametesten uitgelegd: hoe het werkt, wanneer het helpt en wanneer het pijn doet

Snapshot-testen uitgelegd met een pytest- en stroperige demo die we hebben uitgevoerd: snapshots maken, de diff lezen na een codewijziging, tijdstem…

Lees artikel →
Softwaretesten

Mutatietesten uitgelegd: waarom 100% dekking onze bug nog steeds heeft gemist

Mutatietesten uitgelegd met een kleine mutatietool die we hebben gebouwd en uitgevoerd: 14 mutanten, een testsuite met 100% lijndekking die 79% scoo…

Lees artikel →
Kunstmatige intelligentie

Snelle injectie uitgelegd: hoe AI-apps worden misleid en hoe u ze kunt verdedigen

Snelle injectie uitgelegd voor bouwers: directe en indirecte aanvallen, waarom zoekwoordfilters falen (onze test blokkeerde 1 van de 4) en gelaagde …

Lees artikel →
DevOps

DNS-records uitgelegd: A, AAAA, CNAME, MX, TXT en TTL met echte zoekopdrachten

DNS-records uitgelegd met zoekopdrachten die we hebben uitgevoerd: hoe resolutie werkt, A en AAAA, CNAME-regels, MX en null MX, TXT voor SPF en veri…

Lees artikel →
DevOps

Functievlaggen uitgelegd: veilige releases, geleidelijke implementatie en vlaghygiëne

Functievlaggen uitgelegd aan de hand van een uitrolsimulatie die we hebben uitgevoerd: vlagtypen, percentage-uitrol met stabiele hashing, kill-schak…

Lees artikel →
Testautomatisering

Test het genereren van gegevens met Python Faker: realistische, herhaalbare en veilige gegevens

Test het genereren van gegevens met Python Faker, voer het uit en meet het: seeden voor herhaalbare gegevens, landinstellingen, unieke waarden, dome…

Lees artikel →
Softwaretesten

Shift-Left-testen uitgelegd: vind bugs eerder zonder het team te vertragen

Shift-left-testen uitgelegd: wat het betekent, waarom vroege defecten goedkoper zijn, praktijken van vereistenbeoordelingen tot CI-controles, de ver…

Lees artikel →
Databases & SQL

SQL String-functies uitgelegd: TRIM, SUBSTR, REPLACE, CONCAT en gegevensopschoning

SQL-tekenreeksfuncties uitgelegd met query's die we hebben uitgevoerd: concatenatie en NULL, TRIM, UPPER en LOWER, SUBSTR en INSTR, REPLACE, opvulli…

Lees artikel →
Databases & SQL

SQL-triggers uitgelegd: VOOR en NA triggers, auditlogboeken en valkuilen

SQL-triggers uitgelegd met triggers die we hebben uitgevoerd: VOOR versus NA, OUD en NIEUW, auditlogboeken, validatie, voorraadupdates, WANNEER-voor…

Lees artikel →
Softwareontwikkeling

Python JSON-module uitgelegd: dumps, ladingen, aangepaste typen en veelvoorkomende fouten

De Python JSON-module uitgelegd met code die we hebben uitgevoerd: dumps en laadt, bestanden, typeconversies, datums en decimalen, aangepaste encode…

Lees artikel →
Softwareontwikkeling

ES-modules versus CommonJS: hoe JavaScript-import werkt in Node.js, getest

ES-modules versus CommonJS uitgelegd met code die we in Node.js hebben uitgevoerd: syntaxis importeren en exporteren, vereisen, live bindingen, cach…

Lees artikel →
Softwareontwikkeling

Python Regex uitgelegd: patronen, groepen, vooruitblik en valkuilen, getest

Python-regex uitgelegd met patronen die we hebben uitgevoerd: zoeken versus match, findall, groepen en benoemde groepen, hebzuchtig versus lui, sub,…

Lees artikel →
Kunstmatige intelligentie

LLM Gestructureerde uitvoer uitgelegd: betrouwbare JSON verkrijgen uit AI-modellen

Gestructureerde LLM-uitvoer uitgelegd met validatie die we in Pydantic hebben uitgevoerd: JSON-modus en -schema's, beperkte decodering, de manieren …

Lees artikel →
DevOps

SSH-sleutels uitgelegd: hoe ze werken, ssh-keygen, Ed25519 en veilige gewoonten

SSH-sleutels uitgelegd met sleutels die we hebben gegenereerd: openbare versus privésleutels, ssh-keygen, Ed25519 versus RSA, vingerafdrukken, wacht…

Lees artikel →
DevOps

HTTP-caching uitgelegd: cachecontrole, ETag en 304 reacties, met een live test

HTTP-caching uitgelegd met een kleine server die we draaiden: Cache-Control-richtlijnen, max-age, no-cache vs no-store, ETag-hervalidatie en 304-rea…

Lees artikel →
Testautomatisering

API-contracttesten uitgelegd: ontdek belangrijke wijzigingen voordat ze worden verzonden

Het testen van API-contracten uitgelegd met een schemacontrole die we hebben uitgevoerd: wat een contract is, consumentgestuurde contracten, Pact, O…

Lees artikel →
Softwaretesten

Risicogebaseerd testen uitgelegd: scoor risico's, bouw een matrix en test wat belangrijk is

Risicogebaseerd testen stap voor stap uitgelegd: risico's identificeren, waarschijnlijkheid en impact scoren, een risicomatrix opbouwen, risico's in…

Lees artikel →
Databases & SQL

SQL-beperkingen uitgelegd: NIET NULL, UNIEK, CHECK en FOREIGN KEY, getest

SQL-beperkingen uitgelegd met tests die we hebben uitgevoerd: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY en FOREIGN KEY, de NULL-mazen in de wet, de …

Lees artikel →
Databases & SQL

SQL-datumfuncties uitgelegd: datums toevoegen, vergelijken en groeperen zonder bugs

SQL-datumfuncties uitgelegd met query's die we hebben uitgevoerd: intervallen toevoegen, verrassingen aan het einde van de maand, datumverschillen, …

Lees artikel →
Softwareontwikkeling

Python asyncio uitgelegd: async, wachten, verzamelen en TaskGroup met echte timing

Python asyncio uitgelegd met code die we hebben getimed: coroutines, wachten, verzamelen, TaskGroup, foutafhandeling, time-outs, het beperken van ge…

Lees artikel →
Softwareontwikkeling

Debounce versus Throttle in JavaScript: hoe ze werken, wanneer ze moeten worden gebruikt, getest

Debounce versus gas geven in JavaScript uitgelegd met timings die we hebben gemeten in Node.js: hoe elk werkt, eenvoudige implementaties, leidende e…

Lees artikel →
Softwareontwikkeling

Python-contextmanagers uitgelegd: de with-verklaring, contextlib en echt gebruik

Python-contextmanagers uitgelegd met code die we hebben uitgevoerd: hoe met werken, __enter__ en __exit__, contextlib.contextmanager, suppress, Exit…

Lees artikel →
Kunstmatige intelligentie

LLM Temperatuur en Top-p uitgelegd: hoe AI-modellen hun volgende woord kiezen

LLM-temperatuur en top-p uitgelegd met een simulatie die we hebben uitgevoerd: hoe kansen worden hervormd, wat top-p behoudt, aanbevolen instellinge…

Lees artikel →
DevOps

YAML uitgelegd: syntaxis, het Noorwegen-probleem en andere valkuilen die we hebben getest

YAML legde uit met een parsertest: basissyntaxis, lijsten en kaarten, het Noorwegen-probleem, versies die in floats veranderen, octale postcodes, se…

Lees artikel →
DevOps

Cron Jobs uitgelegd: syntaxis, echte schema's en de fouten die deze breken

Cron-taken uitgelegd met schema's die we hebben geverifieerd: de vijf velden, operators, echte voorbeelden, de dag-van-maand OF dag-van-week-valkuil…

Lees artikel →
Kunstmatige intelligentie

AI-hallucinaties uitgelegd: waarom taalmodellen dingen verzinnen en hoe ze te verminderen

AI-hallucinaties uitgelegd: wat ze zijn, waarom taalmodellen ze produceren, veelvoorkomende typen, hoe je ze kunt verminderen met aarding en aanwijz…

Lees artikel →
DevOps

Omgevingsvariabelen uitgelegd: .env-bestanden, geheimen en configuratie goed gedaan

Omgevingsvariabelen uitgelegd met Python-voorbeelden die we hebben uitgevoerd: ze lezen en instellen, waarom elke waarde een string is, .env-bestand…

Lees artikel →
Softwareontwikkeling

API-snelheidsbeperking uitgelegd: algoritmen, headers en afhandeling van 429-fouten

API-snelheidsbeperking uitgelegd met een simulatie die we hebben uitgevoerd: token-bucket, vast venster, schuifvenster, 429 reacties, headers van sn…

Lees artikel →
Testautomatisering

Spotten in Python: unittest.mock, patch en de fouten die tests doen liegen

Spotten in Python met unittest.mock, getest: Mock en return_value, side_effect, patchen waar een naam wordt gebruikt, spec en autospec, spotdatums e…

Lees artikel →
Softwaretesten

Codedekking uitgelegd: lijn versus filiaaldekking en wat 100% werkelijk betekent

Codedekking uitgelegd met een echte dekking.py-run: dekking van lijnen, vertakkingen en condities, een rapport lezen, waarom 100% dekking nog steeds…

Lees artikel →
Databases & SQL

DELETE versus TRUNCATE versus DROP in SQL: verschillen, terugdraaien en wanneer elk te gebruiken

DELETE versus TRUNCATE versus DROP uitgelegd met geteste SQL: wat elk verwijdert, terugdraaien, triggers, identiteitsreset, snelheid en hoe PostgreS…

Lees artikel →
Databases & SQL

SQL-weergaven uitgelegd: creëer, gebruik en vermijd de valkuilen, met voorbeelden

SQL-weergaven uitgelegd met query's die we hebben uitgevoerd: een weergave maken, live resultaten, kolommen verbergen, prestaties, bijwerkbare en ge…

Lees artikel →
Softwareontwikkeling

TypeScript-interface versus type: echte verschillen, getest met de compiler

TypeScript-interface versus type, gecontroleerd met de echte compiler: wat beide kunnen doen, wat slechts één kan doen, samenvoegen van declaraties,…

Lees artikel →
Softwareontwikkeling

Python *args en **kwargs uitgelegd: flexibele functies met duidelijke voorbeelden

Python *args en **kwargs uitgelegd met code die we hebben uitgevoerd: in- en uitpakken, parametervolgorde, argumenten die alleen trefwoorden en posi…

Lees artikel →
Softwareontwikkeling

Python Lambda-functies: syntaxis, echt gebruik en wanneer u ze niet moet gebruiken

Python lambda-functies uitgelegd met code die we hebben uitgevoerd: syntaxis, sorteren met sleutel, kaart en filter, sluitingen, de laat-bindende va…

Lees artikel →
Kunstmatige intelligentie

Wat zijn AI-agenten? Hoe ze werken, met een eenvoudige agentloop die u kunt uitvoeren

Wat zijn AI-agenten? Een duidelijke gids voor de agentenlus, tools, geheugen en vangrails, met een kleine Python-lus die we hebben uitgevoerd, echte…

Lees artikel →
DevOps

Monitoring versus waarneembaarheid: het echte verschil, met logboeken, statistieken en sporen

Monitoring versus waarneembaarheid uitgelegd: bekende en onbekende fouten, logboeken, statistieken en sporen, een walkthrough voor afrekenincidenten…

Lees artikel →
DevOps

Docker-volumes versus bindingsmounts: bewaar containergegevens op de juiste manier

Docker-volumes versus bind-mounts uitgelegd: waarom containergegevens verdwijnen, benoemde volumes, bind-mounts, tmpfs, Compose-voorbeelden, back-up…

Lees artikel →
Testautomatisering

TDD versus BDD: belangrijkste verschillen, één functie die op beide manieren is gebouwd en wanneer deze moet worden gebruikt

TDD versus BDD uitgelegd met één kortingsfunctie die in beide richtingen is gebouwd: rood-groen-refactor met code die we hebben uitgevoerd, gegeven-…

Lees artikel →
Softwaretesten

Gebruikersacceptatietesten (UAT): proces, checklist en echte voorbeelden

Gebruikersacceptatietesten uitgelegd: wie voert het uit, hoe het verschilt van QA, een proces in zeven stappen, een UAT-testcase-sjabloon, een check…

Lees artikel →
Databases & SQL

SQL NULL-waarden uitgelegd: IS NULL, COALESCE, NULLIF en de te vermijden vallen

SQL NULL-waarden uitgelegd met query's die we hebben uitgevoerd: logica met drie waarden, IS NULL, COALESCE, NULLIF, hoe aggregaten, joins en sorter…

Lees artikel →
Databases & SQL

SQL CASE WHEN-instructie: syntaxis, echte voorbeelden en veelvoorkomende fouten

SQL CASE WHEN uitgelegd met vragen die we hebben uitgevoerd: eenvoudige en doorzochte formulieren, volgorde van de voorwaarden, draaipunten met SUM,…

Lees artikel →
Softwareontwikkeling

Wat is JWT? JSON-webtokens uitgelegd met een werkend voorbeeld

Wat is JWT? JSON Web Tokens uitgelegd: de drie delen, een token gebouwd en waarmee is geknoeid in de code die we hebben uitgevoerd, JWT versus sessi…

Lees artikel →
Softwareontwikkeling

JavaScript-gebeurtenislus uitgelegd: call-stack, microtaken en timers met voorbeelden

De JavaScript-gebeurtenislus uitgelegd met code die we hebben uitgevoerd: call-stack, taak- en microtask-wachtrijen, waarom setTimeout 0 niet onmidd…

Lees artikel →
Softwareontwikkeling

Python-generatoren en opbrengst uitgelegd: bespaar geheugen met echte voorbeelden

Python-generatoren en opbrengst uitgelegd met code die we hebben uitgevoerd: hoe ze pauzeren en hervatten, gemeten geheugenbesparingen, pijplijnen, …

Lees artikel →
Kunstmatige intelligentie

Wat zijn inbeddingen? Vectoren en cosinusovereenkomst eenvoudig uitgelegd

Wat zijn insluitingen? Een gids in duidelijke taal over vectoren, cosinusovereenkomst en semantisch zoeken, met een klein voorbeeld dat we hebben ui…

Lees artikel →
DevOps

Implementatie van blauwgroen versus kanarie: verschillen, afwegingen en hoe te kiezen

Blauw-groen versus kanarie-implementatie uitgelegd: hoe elk werkt, kosten, risico's en terugdraaien, stabiele gebruikersbucket die we hebben getest,…

Lees artikel →
Testautomatisering

Schilferige tests: wat de oorzaak ervan is en hoe u ze voorgoed kunt oplossen

Zwakke tests uitgelegd met demo's die we hebben uitgevoerd: de belangrijkste oorzaken, hoe je er een kunt bevestigen en diagnosticeren, goede oploss…

Lees artikel →
Softwaretesten

Belastingtesten versus stresstesten: verschillen, statistieken en k6-voorbeelden

Belastingtesten versus stresstesten uitgelegd: wat elk bewijst, piek- en soak-tests, de statistieken die er toe doen, waarom gemiddelden misleiden, …

Lees artikel →
Softwaretesten

Testcase versus testscenario: belangrijkste verschillen, voorbeelden en wanneer deze te gebruiken

Testcase versus testscenario uitgelegd: duidelijke definities, een tabel naast elkaar, één functie voor het opnieuw instellen van wachtwoorden, over…

Lees artikel →
Databases & SQL

Optimalisatie van SQL-query's: lees uitvoeringsplannen en repareer langzame query's, met timing

Optimalisatie van SQL-query's getest op een miljoen rijen: lees uitvoeringsplannen, voeg de juiste indexen toe, repareer niet-sargeerbare filters, g…

Lees artikel →
Databases & SQL

SQL UNION versus UNION ALL: verschillen, voorbeelden en geteste prestaties

SQL UNION versus UNION ALL uitgelegd met de query's die we hebben uitgevoerd: duplicaten, de regels volgen beide, een echte databug, gemeten prestat…

Lees artikel →
Softwareontwikkeling

JavaScript Fetch API-tutorial: GET, POST, foutafhandeling en time-outs

Een JavaScript Fetch API-tutorial getest tegen een lokale server: GET en POST, waarom 404 niet gooit, een herbruikbare helper, queryreeksen, time-ou…

Lees artikel →
Softwareontwikkeling

Python-bestandsverwerking: lezen, schrijven, CSV, JSON en pathlib met voorbeelden

Het verwerken van Python-bestanden uitgelegd met code die we hebben uitgevoerd: open modi, met het lezen van grote bestanden, CSV, JSON, pathlib, bi…

Lees artikel →
Softwareontwikkeling

Python-klassen en -objecten: OOP-zelfstudie met echte voorbeelden

Python-klassen en -objecten uitgelegd met code die we hebben uitgevoerd: __init__, methoden, klasse versus instantie-attributen, overerving, eigensc…

Lees artikel →
Kunstmatige intelligentie

Wat is een groot taalmodel? Hoe LLM's werken, uitgelegd zonder de hype

Wat is een groot taalmodel? LLM's uitgelegd in duidelijke taal: tokens, inbedding, aandacht, training, temperatuur- en contextvensters, een kleine d…

Lees artikel →
DevOps

Linux-opdrachten voor beginners: de essentiële terminalgids met voorbeelden

Linux-opdrachten voor beginners, gegroepeerd op taak: navigatie, bestanden, logboeken bekijken, grep, pipelines, machtigingen, processen en archieve…

Lees artikel →
Testautomatisering

Selenium versus toneelschrijver: belangrijkste verschillen, code vergeleken en welke te kiezen

Selenium versus Playwright vergeleken: architectuur, wachten, browser- en taalondersteuning, debuggen, dezelfde test in beide tools, migratieadvies …

Lees artikel →
Softwaretesten

Equivalentiepartitionering: testontwerptechniek uitgelegd met uitgewerkte voorbeelden

Equivalentiepartitionering uitgelegd: hoe je geldige en ongeldige partities kunt vinden, uitgewerkte voorbeelden voor leeftijden, wachtwoorden en ko…

Lees artikel →
Softwaretesten

Ernst versus prioriteit bij het testen van software: verschillen, matrix en echte voorbeelden

Ernst versus prioriteit bij het testen van software uitgelegd: duidelijke definities, een vierwegmatrix met voorbeelden, niveauschalen, wie deze bep…

Lees artikel →
Databases & SQL

Tutorial voor SQL-subquery's: typen, gecorreleerde subquery's en BESTAAN met voorbeelden

Een SQL-subquery-tutorial met query's die we hebben uitgevoerd: scalaire, IN-, FROM- en SELECT-subquery's, gecorreleerde subquery's, EXISTS, de NOT …

Lees artikel →
Databases & SQL

SQL-transacties en ACID uitgelegd: COMMIT-, ROLLBACK- en isolatieniveaus

SQL-transacties en ACID uitgelegd met een bankoverschrijving die we hebben uitgevoerd: COMMIT, ROLLBACK, savepoints, locks, isolatieniveaus, dirty r…

Lees artikel →
Softwareontwikkeling

Git Commands Cheat Sheet: de commando's die je daadwerkelijk gebruikt, met voorbeelden

Een spiekbriefje voor Git-opdrachten, gegroepeerd op taak: setup, staging, branches, remotes, stash, geschiedenis en fouten ongedaan maken, met uitv…

Lees artikel →
Softwareontwikkeling

JavaScript-beloften uitgelegd: vervolgens catch, Promise.all en veelvoorkomende fouten

JavaScript-beloften uitgelegd met code die we hebben uitgevoerd: staten, dan en catch-ketens, foutafhandeling, Promise.all, allSettled, race en wat …

Lees artikel →
Softwareontwikkeling

Zelfstudie Python-woordenboek: methoden, voorbeelden en veelvoorkomende patronen

Een Python-woordenboektutorial met code die we hebben uitgevoerd: dictaten, sleutelmethoden, samenvoeg-, begrips-, tel- en groeperingspatronen en ve…

Lees artikel →
Kunstmatige intelligentie

Wat is RAG? Retrieval-Augmented Generation uitgelegd met een werkend voorbeeld

Wat is RAG? Retrieval-augmented generatie stap voor stap uitgelegd: indexeren, chunken, insluiten, ophalen, een klein werkend Python-voorbeeld, eval…

Lees artikel →
DevOps

Terraform-zelfstudie voor beginners: infrastructuur als code van het eerste bestand tot modules

Een Terraform-tutorial voor beginners: begin zonder cloudaccount, leer init, plan en pas toe, vervolgens variabelen, outputs, status, modules en een…

Lees artikel →
DevOps

Docker versus Kubernetes: belangrijkste verschillen, hoe ze samenwerken en welke u nodig heeft

Docker vs Kubernetes legde uit: wat elk doet, dezelfde app draait met beide, Docker Compose en Swarm vergeleken, de dockershim veranderen en hoe je …

Lees artikel →
Testautomatisering

Pytest-tutorial voor beginners: armaturen, parametriseren en echte voorbeelden

Een pytest-tutorial voor beginners met tests die we hebben uitgevoerd op pytest 9.2: beweringen, armaturen, parametrize, conftest, markers, tmp_path…

Lees artikel →
Softwaretesten

Levenscyclus van softwaretests (STLC): 6 fasen, in- en uitgangscriteria, voorbeeld

De levenscyclus van softwaretesten uitgelegd: zes STLC-fasen met in- en uitstapcriteria, deliverables, een voorbeeld van een uitgewerkte inlogfuncti…

Lees artikel →
Softwareontwikkeling

Git merge vs rebase: verschillen, voorbeelden en wanneer je wat gebruikt

Git merge vs rebase uitgelegd met echte logoutput, een vergelijkingstabel, de gouden regel van rebase en een veilige teamwerkwijze.

Lees artikel →
Softwareontwikkeling

Python list comprehension: syntaxis, voorbeelden en wanneer je het vermijdt

Python list comprehension uitgelegd: syntaxis, filteren, if-else, geneste lussen, gemeten tijden en wanneer een gewone for-lus beter is.

Lees artikel →
Databases & SQL

SQL JOIN uitgelegd met voorbeelden (Inner, Left, Right, Full)

Begrijp SQL joins stap voor stap met voorbeeldtabellen en queries: INNER, LEFT, RIGHT, FULL, CROSS en SELF, plus veelgemaakte fouten en prestatietips.

Lees artikel →