L’idempotence de l’API expliquée : Clés d’idempotence et tentatives sécurisées, testées
L’idempotence de l’API signifie qu’envoyer deux fois la même requête a le même effet que l’envoyer une fois. Découvrez quelles méthodes HTTP sont idempotentes, pourquoi POST a besoin d’une clé d’idempotence et comment en créer une en toute sécurité, avec une démo Python qui a transformé une double charge en une seule.
- L’idempotence de l’API signifie que la répétition d’une requête ne répète pas son effet secondaire. GET, PUT et DELETE sont idempotents par définition ; POST ne l’est pas.
- Dans notre démo, une réponse perdue suivie d’une nouvelle tentative créait deux charges sans clé et une avec un
Idempotency-Key. - Stocker une empreinte digitale du corps de la requête avec la clé : réutiliser une clé avec un corps différent a renvoyé 422 dans notre serveur.
- Réclamez la clé de manière atomique. Deux tentatives simultanées ont obtenu 201 et 409, et une seule charge a été effectuée.
Les réseaux échouent au pire endroit possible : après que le serveur a effectué le travail mais avant que le client n’ait une réponse. Le client voit un délai d’attente, réessaye et un client est facturé deux fois ou une commande est expédiée deux fois. L’idempotence de l’API est la règle de conception qui sécurise ces tentatives, et les clés d’idempotence sont le moyen standard de l’appliquer aux requêtes qui créent des éléments.
Pour montrer le problème plutôt que de le décrire, nous avons écrit une petite API de paiement avec le serveur HTTP intégré de Python 3.13 et un client qui réessaye après une interruption de connexion. Tout s’est exécuté localement et les sorties ci-dessous sont copiées à partir de cette exécution. Les vrais prestataires de paiement ajoutent bien plus, alors considérez le code comme un modèle pédagogique. Pour la conception générale de l’API, consultez nos meilleures pratiques de l’API REST.
Qu’est-ce que l’idempotence ?
Une opération est idempotente si elle est effectuée une ou plusieurs fois et laisse le système dans le même état. Régler un interrupteur sur « off » est idempotent : appuyer cinq fois sur « off » le laisse toujours éteint. Basculer l’interrupteur ne l’est pas, car chaque pression change le résultat.
Notez que l’idempotence concerne l’effet sur le serveur, pas la réponse. Supprimer une commande deux fois est idempotent même si le deuxième appel renvoie 404, car la commande est terminée dans un sens ou dans l’autre. Un mot apparenté, safe, signifie que la requête ne change rien du tout, comme GET.
Quelles méthodes HTTP sont idempotentes ?
La spécification HTTP, RFC 9110, définit ces propriétés pour chaque méthode :
| Méthode | Coffre-fort | Idempotent | Utilisation typique |
|---|---|---|---|
| OBTENIR, TÊTE, OPTIONS | Oui | Oui | Lire des données |
| METTRE | Non | Oui | Remplacer une ressource par une URL connue |
| SUPPRIMER | Non | Oui | Supprimer une ressource |
| POSTER | Non | Non | Créer une ressource ou déclencher une action |
| CORRECTIF | Non | Non garanti | Mise à jour partielle |
Le tableau décrit ce que les serveurs devraient faire. Un PUT mal conçu qui incrémente un compteur rompt la promesse. Et PATCH dépend de la charge utile : « définir la quantité sur 3 » est idempotent, tandis que « ajouter 1 à la quantité » ne l’est pas. Notre aide-mémoire sur les codes d’état HTTP répertorie les réponses que chaque méthode renvoie habituellement.
Le problème de la nouvelle tentative
Un client envoie POST /payments. Trois choses peuvent arriver :
- La requête n’atteint jamais le serveur. Réessayer est sûr.
- Le serveur le traite et la réponse arrive. Aucune nouvelle tentative n’est nécessaire.
- Le serveur le traite, mais la réponse est perdue en raison d’un délai d’attente ou d’une interruption de connexion. Le client ne peut pas distinguer cela du cas 1.
Le cas 3 est le cas dangereux. Si le client réessaye, le serveur crée un deuxième paiement. S’il ne réessaye pas, un paiement ayant échoué dans le cas 1 n’est jamais effectué. Sans l’aide du serveur, le client n’a aucun choix sûr.
Comment fonctionnent les clés d’idempotence
Le correctif consiste à attribuer à chaque opération logique un identifiant unique dont le serveur se souvient :
- Le client génère une clé aléatoire, généralement un UUID, et l’envoie dans un en-tête tel que
Idempotency-Key. - Le serveur vérifie s’il a vu la clé. Sinon, il enregistre la clé, effectue le travail et stocke la réponse avec la clé.
- Si la même clé arrive à nouveau, le serveur ignore le travail et renvoie la réponse stockée.
- Les clés expirent après une fenêtre de conservation, généralement environ 24 heures, bien que cela varie selon le fournisseur.
Les fournisseurs de paiement ont popularisé ce modèle et un projet de norme de l’IETF décrit l’en-tête Idempotency-Key pour les API HTTP en général.
Notre serveur de démonstration
Le cœur du serveur est constitué de quelques lignes qui réclament la clé, puis effectuent le travail ou rejouent le résultat stocké :
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)
Pour simuler le cas 3, on peut demander au serveur de terminer la charge puis de fermer la connexion sans répondre. Le client voit une erreur et réessaye avec la même demande.
Résultats : avec et sans clé
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]
Sans clé, le client a été facturé 500 deux fois, et le client n’a vu que la facturation ch_2 ; la première charge est devenue invisible. Avec une clé, la nouvelle tentative a reçu la réponse originale, ch_1, avec un en-tête Idempotent-Replayed: true, et une seule charge existe. Le client a obtenu exactement la réponse qu’il avait manquée la première fois.
Conseil : relisez la réponse stockée, y compris le code d’état. Renvoyer un message différent tel que « demande en double » oblige chaque client à écrire un traitement spécial et va à l’encontre du but.
Réutiliser une clé avec un corps différent
Une clé doit identifier une opération. Si un client envoie accidentellement la même clé avec un montant différent, rejouer l’ancienne réponse serait une erreur, tout comme facturer le nouveau montant. Notre serveur stocke une empreinte SHA-256 du corps avec la clé et la compare :
same key same body: 201 (replayed)
same key different body: (422, {'error': 'key reused with different body'})
Refuser bruyamment transforme un bug client silencieux en un bug évident. Les fournisseurs diffèrent sur le code de statut exact ; le projet de l’IETF suggère 422 pour ce cas.
Nouvelles tentatives simultanées
Les clients agressifs réessayent parfois avant la fin de la première tentative. Si le serveur vérifie la clé puis l’insère en deux étapes distinctes, les deux requêtes peuvent réussir le contrôle et les deux peuvent facturer. Nous avons envoyé deux requêtes identiques avec la même clé au même moment, le travail prenant une demi-seconde :
concurrent same key: [201, 409] charges: [700]
Une demande a remporté la revendication atomique et a été facturée ; l’autre a vu la clé dans l’état processing et a obtenu 409 Conflict, qui indique au client d’attendre et de réessayer. En production, le verrou est remplacé par une contrainte unique de base de données ou une opération atomique « insérer en cas d’absence » telle que Redis SET NX, il fonctionne donc sur de nombreux serveurs.
Liste de contrôle de conception de serveur
- Étendez les clés au compte ou à la clé API, afin que deux clients ne puissent pas entrer en collision.
- Réclamez avant de travailler, atomiquement, et enregistrez un état
processing. - Stockez la réponse complète, l’état et le corps, une fois le travail terminé.
- Prenez une empreinte digitale de la demande et rejetez la réutilisation incompatible.
- Gérez les échecs délibérément. Si le travail échoue en raison d’une erreur de serveur, relâchez la clé pour pouvoir réessayer ; s’il échoue à la validation, stockez et rejouez l’erreur.
- Expire les clés après une fenêtre documentée et conservez l’effet secondaire et l’enregistrement de la clé dans la même transaction lorsque cela est possible.
- Rendez également les étapes internes idempotentes. Les consommateurs de messages et les gestionnaires de webhook reçoivent des doublons, donc supprimez les doublons sur un ID d’événement.
Règles côté client
- Générez une clé par opération logique, et non par tentative HTTP, et réutilisez-la pour chaque nouvelle tentative de cette opération.
- Réessayez uniquement en cas d’erreurs réseau, de délais d’attente, de réponses 409, 429 et 5xx, avec un intervalle d’attente et une instabilité exponentielle. Notre Guide de limitation du débit API explique l’intervalle de temps.
- Ne réessayez jamais une erreur de validation 4xx inchangée ; cela échouera de la même manière.
- Conservez la clé avec l’opération en attente afin qu’une application redémarrée puisse réessayer en toute sécurité.
Comment tester l’idempotence
Les bugs d’idempotence se cachent jusqu’à ce que le trafic de production soit compliqué, alors testez-les volontairement. Envoyez la même demande deux fois et affirmez qu’une ressource existe. Envoyez la même clé avec un corps différent et affirmez l’erreur. Lancez des requêtes parallèles avec une seule clé et affirmez un seul effet secondaire, comme l’a fait notre test simultané. Supprimez la connexion après la validation du serveur, à l’aide d’un proxy ou d’un hook de test, et vérifiez que la nouvelle tentative obtient la réponse d’origine. Ces vérifications s’intègrent naturellement dans les tests d’API créés avec les outils de notre Guide de test d’API avec Postman.
Pour conclure
L’idempotence de l’API transforme les tentatives de risque en routine. Utilisez des méthodes naturellement idempotentes là où elles conviennent et donnez à chaque POST qui déplace de l’argent ou crée des enregistrements importants une clé d’idempotence. Sur le serveur, réclamez les clés de manière atomique, stockez et rejouez les réponses complètes et refusez la réutilisation avec un corps différent. Notre petite démo a montré la différence en une seule ligne : deux charges n’en font plus qu’une.
Questions fréquentes
Qu’est-ce que l’idempotence dans une API ?
Une opération API est idempotente lorsque la même requête est effectuée plusieurs fois et a le même effet sur le serveur qu’une seule fois, afin que les clients puissent réessayer en toute sécurité.
Le POST est-il idempotent ?
Non. POST crée généralement une nouvelle ressource ou déclenche une action à chaque fois. Ajoutez une clé d’idempotence afin que le serveur puisse reconnaître et ignorer en toute sécurité les tentatives répétées.
Qu’est-ce qu’une clé d’idempotence ?
Il s’agit d’une valeur unique, souvent un UUID, que le client envoie avec une requête. Le serveur stocke le résultat sous cette clé et renvoie le même résultat si la clé est revue.
Combien de temps les clés d’idempotence doivent-elles être conservées ?
Assez long pour couvrir chaque nouvelle tentative réaliste. Environ 24 heures sont courantes, mais les fournisseurs diffèrent, alors documentez votre fenêtre et faites expirer les anciennes clés.
Que doit renvoyer le serveur en cas de demande en double ?
Renvoie la réponse originale stockée avec le même code d’état et le même corps. Si l’original est toujours en cours d’exécution, renvoyez 409 pour que le client réessaye plus tard.
Continuez à apprendre
Besoin d’aide pour les tests, WordPress ou le référencement ?
Nous aidons les équipes à proposer de meilleurs logiciels et à développer leurs sites. Dites-nous sur quoi vous travaillez et nous vous proposerons une prochaine étape claire.
Plus de guides sur tests, IA et développement moderne
Vous avez apprécié cet article ? Choisissez un sujet et accédez directement à nos nouveaux didacticiels.
Stratégies de fragmentation RAG expliquées : fixe, chevauchement, phrase, récursif et en-têtes, mesurés
Stratégies de segmentation RAG comparées sur un document avec tiktoken 0.14 : taille fixe, chevauchement, regroupement de phrases, fractionnement ré…
Lire l'article →Développement logicielL'idempotence de l'API expliquée : clés d'idempotence et tentatives sécurisées, testées
L'idempotence de l'API expliquée avec un serveur et un client Python que nous avons exécutés : une réponse perdue provoquait une double charge sans …
Lire l'article →DevOpsGit Stash expliqué : enregistrer, appliquer, afficher et fichiers non suivis, testé
Git stash expliqué avec les commandes que nous avons exécutées sur Git 2.56 : pousser avec un message, fichiers non suivis, lister et afficher, appl…
Lire l'article →Tests logicielsExplication des tests par paires : comment toutes les paires réduisent 216 tests à 13, testé
Tests par paires expliqués avec un générateur que nous avons exécuté dans Python 3.13 : une vérification avec 216 combinaisons couvertes par 13 test…
Lire l'article →Automatisation des testsExplication des doubles de test : factice, stub, espion, simulé et faux, avec du code Python testé
Les tests doubles sont expliqués avec un exemple Python exécuté dans pytest 9.2 : factice, stub, espion, simulé et faux, quand les utiliser, les vér…
Lire l'article →Bases de données et SQLSQL COALESCE expliqué : valeurs par défaut, NULLIF, IFNULL vs ISNULL et Traps, testées
SQL COALESCE expliqué avec les requêtes que nous avons exécutées dans SQLite 3.50 : premières valeurs non nulles, chaînes vides, NULL en mathématiqu…
Lire l'article →Bases de données et SQLSQL Self Join expliqué : employé-manager, comparaisons de paires et de lignes, testés
L'auto-jointure SQL expliquée avec les requêtes que nous avons exécutées dans SQLite 3.50 : employé et manager, gagnant plus que le manager, paires …
Lire l'article →Développement logicielExplication de l'opérateur de propagation JavaScript : propagation vs repos, copies et pièges, testé
L'opérateur de propagation JavaScript expliqué avec le code que nous avons exécuté sur le nœud 24 : tableaux, objets, copies superficielles, paramèt…
Lire l'article →Développement logicielModule de collections Python expliqué : compteur, defaultdict, deque et plus, testé
Les collections Python expliquées avec le code que nous avons exécuté sur Python 3.13 : Counter, defaultdict, deque, approvedtuple, OrderedDict et C…
Lire l'article →Intelligence artificielleFenêtre contextuelle LLM expliquée : jetons, limites et comment en adapter davantage, mesurés
La fenêtre contextuelle LLM expliquée avec le nombre de jetons que nous avons mesurés à l'aide de tiktoken : mots par rapport aux jetons pour la pro…
Lire l'article →Développement logicielLes webhooks expliqués : comment ils fonctionnent et comment les recevoir en toute sécurité
Webhooks expliqués avec un récepteur et un expéditeur que nous avons exécutés en Python : push vs polling, signatures HMAC-SHA256, rejet des requête…
Lire l'article →DevOpsGit Cherry-Pick expliqué : copiez le commit dont vous avez besoin, en toute sécurité et testé
Git Cherry-pick expliqué avec les commandes que nous avons exécutées dans Git 2.56 : copie d'un correctif dans une branche de version, nouveaux hach…
Lire l'article →Automatisation des testsLes tests instantanés expliqués : comment cela fonctionne, quand cela aide et quand cela fait mal
Les tests d'instantanés expliqués avec une démo pytest et sirupeuse que nous avons exécutée : création d'instantanés, lecture de la différence après…
Lire l'article →Tests logicielsTests de mutation expliqués : pourquoi une couverture à 100 % n'a toujours pas détecté notre bug
Les tests de mutation expliqués avec un petit outil de mutation que nous avons construit et exécuté : 14 mutants, une suite de tests avec une couver…
Lire l'article →Intelligence artificielleL'injection rapide expliquée : comment les applications d'IA sont trompées et comment les défendre
L'injection rapide expliquée aux constructeurs : attaques directes et indirectes, pourquoi les filtres de mots clés échouent (notre test a bloqué 1 …
Lire l'article →DevOpsEnregistrements DNS expliqués : A, AAAA, CNAME, MX, TXT et TTL avec de vraies recherches
Enregistrements DNS expliqués avec les recherches que nous avons effectuées : fonctionnement de la résolution, A et AAAA, règles CNAME, MX et null M…
Lire l'article →DevOpsExplication des indicateurs de fonctionnalités : versions sécurisées, déploiements progressifs et hygiène des indicateurs
Les indicateurs de fonctionnalités expliqués avec une simulation de déploiement que nous avons exécutée : types d'indicateurs, déploiements en pourc…
Lire l'article →Automatisation des testsGénération de données de test avec Python Faker : données réalistes, reproductibles et sûres
Testez la génération de données avec Python Faker, exécutez et mesurez : amorçage de données répétables, paramètres régionaux, valeurs uniques, enre…
Lire l'article →Tests logicielsExplication des tests Shift-Left : recherchez les bugs plus tôt sans ralentir l'équipe
Les tests Shift-Left ont expliqué : ce que cela signifie, pourquoi les premiers défauts sont moins chers, les pratiques allant de l'examen des exige…
Lire l'article →Bases de données et SQLFonctions de chaîne SQL expliquées : TRIM, SUBSTR, REPLACE, CONCAT et nettoyage des données
Fonctions de chaîne SQL expliquées avec les requêtes que nous avons exécutées : concaténation et NULL, TRIM, UPPER et LOWER, SUBSTR et INSTR, REPLAC…
Lire l'article →Bases de données et SQLDéclencheurs SQL expliqués : déclencheurs AVANT et APRÈS, journaux d'audit et pièges
Déclencheurs SQL expliqués avec les déclencheurs que nous avons exécutés : AVANT ou APRÈS, ANCIEN et NOUVEAU, journaux d'audit, validation, mises à …
Lire l'article →Développement logicielModule Python JSON expliqué : vidages, chargements, types personnalisés et erreurs courantes
Le module Python JSON expliqué avec le code que nous avons exécuté : dumps et chargements, fichiers, conversions de types, dates et décimales, encod…
Lire l'article →Développement logicielModules ES vs CommonJS : fonctionnement des importations JavaScript dans Node.js, testé
Les modules ES et CommonJS expliqués avec le code que nous avons exécuté dans Node.js : syntaxe d'importation et d'exportation, exigences, liaisons …
Lire l'article →Développement logicielPython Regex expliqué : modèles, groupes, anticipations et pièges, testés
L'expression régulière Python expliquée avec les modèles que nous avons exécutés : recherche contre correspondance, recherche tout, groupes et group…
Lire l'article →Intelligence artificielleExplication de la sortie structurée LLM : obtenir un JSON fiable à partir de modèles d'IA
Sortie structurée LLM expliquée avec la validation que nous avons exécutée dans Pydantic : mode et schémas JSON, décodage contraint, façons dont les…
Lire l'article →DevOpsClés SSH expliquées : comment elles fonctionnent, ssh-keygen, Ed25519 et habitudes sûres
Clés SSH expliquées avec les clés que nous avons générées : clés publiques ou privées, ssh-keygen, Ed25519 vs RSA, empreintes digitales, phrases sec…
Lire l'article →DevOpsLa mise en cache HTTP expliquée : Cache-Control, ETag et 304 réponses, avec un test en direct
La mise en cache HTTP expliquée avec un petit serveur que nous avons exécuté : directives Cache-Control, max-age, no-cache vs no-store, revalidation…
Lire l'article →Automatisation des testsExplication des tests des contrats API : détectez les modifications majeures avant leur expédition
Les tests de contrat API ont été expliqués à l'aide d'une vérification de schéma que nous avons effectuée : ce qu'est un contrat, les contrats axés …
Lire l'article →Tests logicielsExplication des tests basés sur les risques : évaluez les risques, créez une matrice et testez ce qui compte
Les tests basés sur les risques sont expliqués étape par étape : identification des risques, notation de la probabilité et de l'impact, création d'u…
Lire l'article →Bases de données et SQLContraintes SQL expliquées : NOT NULL, UNIQUE, CHECK et FOREIGN KEY, testées
Les contraintes SQL expliquées avec les tests que nous avons exécutés : NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY et FOREIGN KEY, les failles NULL, …
Lire l'article →Bases de données et SQLFonctions de date SQL expliquées : ajout, comparaison et regroupement de dates sans bugs
Fonctions de date SQL expliquées avec les requêtes que nous avons exécutées : ajout d'intervalles, surprises de fin de mois, différences de dates, p…
Lire l'article →Développement logicielPython asyncio expliqué : asynchrone, attendre, rassembler et TaskGroup avec des timings réels
Python asyncio expliqué avec le code que nous avons chronométré : coroutines, wait, collect, TaskGroup, gestion des erreurs, délais d'attente, limit…
Lire l'article →Développement logicielDebounce vs Throttle en JavaScript : comment ils fonctionnent, quand les utiliser, testés
Debounce vs throttle en JavaScript expliqué avec les timings que nous avons mesurés dans Node.js : comment chacun fonctionne, implémentations simple…
Lire l'article →Développement logicielLes gestionnaires de contexte Python expliqués : l'instruction with, contextlib et les utilisations réelles
Les gestionnaires de contexte Python ont expliqué avec le code que nous avons exécuté : comment cela fonctionne, __enter__ et __exit__, contextlib.c…
Lire l'article →Intelligence artificielleTempérature LLM et Top-p expliqués : comment les modèles d'IA choisissent leur prochain mot
La température LLM et le top-p expliqués à l'aide d'une simulation que nous avons exécutée : comment les probabilités sont remodelées, ce que conser…
Lire l'article →DevOpsYAML expliqué : syntaxe, problème norvégien et autres pièges que nous avons testés
YAML expliqué avec un test d'analyseur : syntaxe de base, listes et cartes, le problème de la Norvège, les versions se transformant en flottants, co…
Lire l'article →DevOpsLes tâches Cron expliquées : syntaxe, horaires réels et erreurs qui les interrompent
Les tâches Cron expliquées avec les plannings que nous avons vérifiés : les cinq champs, les opérateurs, des exemples réels, le piège du jour du moi…
Lire l'article →Intelligence artificielleLes hallucinations de l'IA expliquées : pourquoi les modèles de langage inventent les choses et comment les réduire
Les hallucinations de l'IA ont expliqué : ce qu'elles sont, pourquoi les modèles de langage les produisent, les types courants, comment les réduire …
Lire l'article →DevOpsVariables d'environnement expliquées : fichiers .env, secrets et configuration correctement effectués
Variables d'environnement expliquées avec des exemples Python que nous avons exécutés : lecture et définition, pourquoi chaque valeur est une chaîne…
Lire l'article →Développement logicielLimitation du débit de l'API expliquée : algorithmes, en-têtes et gestion des erreurs 429
Limitation du débit de l'API expliquée avec une simulation que nous avons exécutée : compartiment de jetons, fenêtre fixe, fenêtre glissante, 429 ré…
Lire l'article →Automatisation des testsSe moquer en Python : unittest.mock, patch et les erreurs qui font mentir les tests
Moquerie en Python avec unittest.mock, testée : Mock et return_value, side_effect, correctifs où un nom est utilisé, spec et autospec, dates moqueus…
Lire l'article →Tests logicielsCouverture du code expliquée : couverture des lignes par rapport aux branches et ce que signifie réellement 100 %
Couverture du code expliquée avec une véritable exécution de cover.py : couverture des lignes, des branches et des conditions, lecture d'un rapport,…
Lire l'article →Bases de données et SQLDELETE vs TRUNCATE vs DROP dans SQL : différences, restauration et quand les utiliser
DELETE vs TRUNCATE vs DROP expliqué avec SQL testé : ce que chacun supprime, restauration, déclencheurs, réinitialisation d'identité, vitesse et en …
Lire l'article →Bases de données et SQLVues SQL expliquées : créez, utilisez et évitez les pièges, avec des exemples
Vues SQL expliquées avec les requêtes que nous avons exécutées : création d'une vue, résultats en direct, masquage des colonnes, performances, vues …
Lire l'article →Développement logicielInterface TypeScript vs Type : différences réelles, testées avec le compilateur
Interface TypeScript vs type, vérifiée avec le vrai compilateur : ce que les deux peuvent faire, ce qu'un seul peut faire, la fusion des déclaration…
Lire l'article →Développement logicielPython *args et **kwargs expliqués : fonctions flexibles avec des exemples clairs
Python *args et **kwargs expliqués avec le code que nous avons exécuté : emballage et déballage, ordre des paramètres, arguments de mot-clé uniqueme…
Lire l'article →Développement logicielFonctions Python Lambda : syntaxe, utilisations réelles et quand ne pas les utiliser
Fonctions Python lambda expliquées avec le code que nous avons exécuté : syntaxe, tri avec clé, carte et filtre, fermetures, piège de liaison tardiv…
Lire l'article →Intelligence artificielleQue sont les agents IA ? Comment ils fonctionnent, avec une simple boucle d'agent que vous pouvez exécuter
Que sont les agents IA ? Un guide simple sur la boucle d'agent, les outils, la mémoire et les garde-fous, avec une petite boucle Python que nous avo…
Lire l'article →DevOpsSurveillance vs observabilité : la vraie différence, avec les journaux, les métriques et les traces
Surveillance et observabilité expliquées : échecs connus et inconnus, journaux, métriques et traces, présentation pas à pas des incidents de paiemen…
Lire l'article →DevOpsVolumes Docker vs montages Bind : conserver les données du conteneur de la bonne manière
Volumes Docker et montages de liaison expliqués : pourquoi les données du conteneur disparaissent, volumes nommés, montages de liaison, tmpfs, exemp…
Lire l'article →Automatisation des testsTDD vs BDD : principales différences, une fonctionnalité conçue dans les deux sens et quand les utiliser
TDD vs BDD expliqué avec une fonctionnalité de remise construite dans les deux sens : refactor rouge-vert avec le code que nous avons exécuté, scéna…
Lire l'article →Tests logicielsTests d'acceptation utilisateur (UAT) : processus, liste de contrôle et exemples réels
Les tests d'acceptation des utilisateurs sont expliqués : qui les exécute, en quoi ils diffèrent du contrôle qualité, un processus en sept étapes, u…
Lire l'article →Bases de données et SQLExplication des valeurs SQL NULL : IS NULL, COALESCE, NULLIF et les pièges à éviter
Les valeurs SQL NULL expliquées avec les requêtes que nous avons exécutées : logique à trois valeurs, IS NULL, COALESCE, NULLIF, comment les agrégat…
Lire l'article →Bases de données et SQLInstruction SQL CASE WHEN : syntaxe, exemples réels et erreurs courantes
SQL CASE WHEN expliqué avec les requêtes que nous avons exécutées : formulaires simples et recherchés, ordre des conditions, pivots avec SUM, astuce…
Lire l'article →Développement logicielQu'est-ce que JWT ? Les jetons Web JSON expliqués avec un exemple fonctionnel
Qu’est-ce que JWT ? JSON Web Tokens expliqué : les trois parties, un jeton construit et falsifié dans le code que nous avons exécuté, JWT vs session…
Lire l'article →Développement logicielBoucle d'événements JavaScript expliquée : pile d'appels, microtâches et minuteries avec des exemples
La boucle d'événements JavaScript expliquée avec le code que nous avons exécuté : pile d'appels, files d'attente de tâches et de microtâches, pourqu…
Lire l'article →Développement logicielGénérateurs Python et rendement expliqués : économisez de la mémoire avec des exemples réels
Les générateurs Python et le rendement expliqués avec le code que nous avons exécuté : comment ils s'arrêtent et reprennent, les économies de mémoir…
Lire l'article →Intelligence artificielleQue sont les intégrations ? Vecteurs et similarité cosinus expliqués simplement
Que sont les intégrations ? Un guide en langage simple sur les vecteurs, la similarité cosinus et la recherche sémantique, avec un petit exemple que…
Lire l'article →DevOpsDéploiement Bleu-Vert vs Canary : différences, compromis et comment choisir
Explication du déploiement bleu-vert ou canari : comment chacun fonctionne, coût, risque et restauration, regroupement d'utilisateurs stable que nou…
Lire l'article →Automatisation des testsTests instables : quelles sont leurs causes et comment les corriger définitivement
Des tests irréguliers expliqués avec des démos que nous avons exécutées : les principales causes, comment en confirmer et en diagnostiquer une, les …
Lire l'article →Tests logicielsTests de charge vs tests de contrainte : différences, métriques et exemples k6
Explication des tests de charge et des tests de stress : ce que chacun prouve, les tests de pointe et de trempage, les métriques qui comptent, pourq…
Lire l'article →Tests logicielsScénario de test et scénario de test : principales différences, exemples et quand les utiliser
Scénario de test et scénario de test expliqués : des définitions claires, un tableau côte à côte, une fonctionnalité de réinitialisation de mot de p…
Lire l'article →Bases de données et SQLOptimisation des requêtes SQL : lire les plans d'exécution et corriger les requêtes lentes, avec des délais
Optimisation des requêtes SQL testée sur un million de lignes : lire les plans d'exécution, ajouter les bons index, corriger les filtres non Sargabl…
Lire l'article →Bases de données et SQLSQL UNION vs UNION ALL : différences, exemples et performances testées
SQL UNION vs UNION ALL expliqué avec les requêtes que nous avons exécutées : des doublons, les règles suivent toutes les deux, un véritable bug de d…
Lire l'article →Développement logicielTutoriel API JavaScript Fetch : GET, POST, gestion des erreurs et délais d'attente
Un didacticiel de l'API JavaScript Fetch testé sur un serveur local : GET et POST, pourquoi 404 ne lance pas, un assistant réutilisable, des chaînes…
Lire l'article →Développement logicielGestion des fichiers Python : lecture, écriture, CSV, JSON et pathlib avec exemples
Gestion des fichiers Python expliquée avec le code que nous avons exécuté : modes ouverts, avec lecture de fichiers volumineux, CSV, JSON, pathlib, …
Lire l'article →Développement logicielClasses et objets Python : didacticiel POO avec des exemples réels
Classes et objets Python expliqués avec le code que nous avons exécuté : __init__, méthodes, attributs de classe par rapport à l'instance, héritage,…
Lire l'article →Intelligence artificielleQu'est-ce qu'un grand modèle de langage ? Comment fonctionnent les LLM, expliqués sans battage médiatique
Qu’est-ce qu’un grand modèle de langage ? Les LLM expliqués en langage simple : jetons, intégrations, attention, formation, fenêtres de température …
Lire l'article →DevOpsCommandes Linux pour les débutants : le guide du terminal essentiel avec des exemples
Commandes Linux pour débutants, regroupées par tâche : navigation, fichiers, affichage des journaux, grep, tuyaux, autorisations, processus et archi…
Lire l'article →Automatisation des testsSelenium vs Playwright : principales différences, code comparé et lequel choisir
Comparatif Selenium vs Playwright : architecture, attente, support du navigateur et du langage, débogage, même test dans les deux outils, conseils d…
Lire l'article →Tests logicielsPartitionnement d'équivalence : technique de conception de tests expliquée avec des exemples concrets
Le partitionnement d'équivalence expliqué : comment trouver des partitions valides et invalides, des exemples concrets d'âges, de mots de passe et d…
Lire l'article →Tests logicielsGravité vs priorité dans les tests logiciels : différences, matrice et exemples réels
Explication de la gravité et de la priorité dans les tests logiciels : des définitions claires, une matrice à quatre voies avec des exemples, des éc…
Lire l'article →Bases de données et SQLTutoriel sur les sous-requêtes SQL : types, sous-requêtes corrélées et EXISTE avec des exemples
Un didacticiel sur les sous-requêtes SQL avec les requêtes que nous avons exécutées : les sous-requêtes scalaires, IN, FROM et SELECT, les sous-requ…
Lire l'article →Bases de données et SQLTransactions SQL et ACID expliquées : COMMIT, ROLLBACK et niveaux d'isolement
Transactions SQL et ACID expliquées avec un virement bancaire que nous avons effectué : COMMIT, ROLLBACK, points de sauvegarde, verrous, niveaux d'i…
Lire l'article →Développement logicielAide-mémoire sur les commandes Git : les commandes que vous utilisez réellement, avec des exemples
Une aide-mémoire sur les commandes Git regroupées par tâche : configuration, transfert, branches, télécommandes, cache, historique et annulation des…
Lire l'article →Développement logicielLes promesses JavaScript expliquées : alors, catch, Promise.all et les erreurs courantes
Les promesses JavaScript expliquées avec le code que nous avons exécuté : les états, les chaînes then et catch, la gestion des erreurs, Promise.all,…
Lire l'article →Développement logicielTutoriel du dictionnaire Python : méthodes, exemples et modèles courants
Un didacticiel de dictionnaire Python avec du code que nous avons exécuté : créer, lire et mettre à jour des dictés, des méthodes clés, des fusions,…
Lire l'article →Intelligence artificielleQu’est-ce que RAG ? La génération augmentée par récupération expliquée avec un exemple fonctionnel
Qu’est-ce que le RAG ? La génération augmentée par récupération expliquée étape par étape : indexation, segmentation, intégrations, récupération, un…
Lire l'article →DevOpsTutoriel Terraform pour les débutants : Infrastructure en tant que code du premier fichier aux modules
Un didacticiel Terraform pour les débutants : commencez sans compte cloud, apprenez l'initialisation, la planification et l'application, puis les va…
Lire l'article →DevOpsDocker vs Kubernetes : principales différences, comment ils fonctionnent ensemble et ce dont vous avez besoin
Docker vs Kubernetes expliqué : ce que chacun fait, la même application s'exécute avec les deux, Docker Compose et Swarm comparés, les dockershim ch…
Lire l'article →Automatisation des testsTutoriel Pytest pour les débutants : luminaires, paramétrage et exemples réels
Un tutoriel pytest pour les débutants avec des tests que nous avons exécutés sur pytest 9.2 : assertions, appareils, paramétrage, conftest, marqueur…
Lire l'article →Tests logicielsCycle de vie des tests logiciels (STLC) : 6 phases, critères d'entrée et de sortie, exemple
Le cycle de vie des tests logiciels expliqué : six phases STLC avec des critères d'entrée et de sortie, des livrables, un exemple de fonctionnalité …
Lire l'article →Développement logicielGit merge vs rebase : différences, exemples et quand utiliser chacun
Git merge vs rebase expliqué avec de vraies sorties de log, un tableau comparatif, la règle d'or du rebase et un flux de travail sûr pour les équipes.
Lire l'article →Développement logicielList comprehension Python : syntaxe, exemples et cas à éviter
La list comprehension Python expliquée : syntaxe, filtres, if-else, boucles imbriquées, temps mesurés et cas où une boucle for classique est préféra…
Lire l'article →Bases de données et SQLJointures SQL expliquées avec exemples (Inner, Left, Right, Full)
Comprenez les jointures SQL pas à pas avec des tables et requêtes d'exemple : INNER, LEFT, RIGHT, FULL, CROSS et SELF, plus erreurs courantes et con…
Lire l'article →