L’idempotence de l’API expliquée : clés d’idempotence et tentatives sécurisées, testées

  1. Accueil
  2. Blog
  3. Développement de logiciels

Développement de logiciels

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.

9 min de lecture
L'idempotence de l'API expliquée : clés d'idempotence et tentatives sécurisées

À retenir

  • 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 :

  1. La requête n’atteint jamais le serveur. Réessayer est sûr.
  2. Le serveur le traite et la réponse arrive. Aucune nouvelle tentative n’est nécessaire.
  3. 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 :

  1. 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.
  2. 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é.
  3. Si la même clé arrive à nouveau, le serveur ignore le travail et renvoie la réponse stockée.
  4. 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

Travailler avec Stack Quora

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.

Continuez à lire

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.

Intelligence artificielle

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 logiciel

L'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 →
DevOps

Git 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 logiciels

Explication 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 tests

Explication 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 SQL

SQL 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 SQL

SQL 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 logiciel

Explication 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 logiciel

Module 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 artificielle

Fenê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 logiciel

Les 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 →
DevOps

Git 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 tests

Les 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 logiciels

Tests 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 artificielle

L'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 →
DevOps

Enregistrements 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 →
DevOps

Explication 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 tests

Gé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 logiciels

Explication 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 SQL

Fonctions 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 SQL

Dé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 logiciel

Module 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 logiciel

Modules 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 logiciel

Python 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 artificielle

Explication 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 →
DevOps

Clé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 →
DevOps

La 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 tests

Explication 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 logiciels

Explication 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 SQL

Contraintes 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 SQL

Fonctions 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 logiciel

Python 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 logiciel

Debounce 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 logiciel

Les 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 artificielle

Tempé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 →
DevOps

YAML 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 →
DevOps

Les 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 artificielle

Les 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 →
DevOps

Variables 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 logiciel

Limitation 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 tests

Se 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 logiciels

Couverture 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 SQL

DELETE 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 SQL

Vues 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 logiciel

Interface 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 logiciel

Python *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 logiciel

Fonctions 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 artificielle

Que 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 →
DevOps

Surveillance 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 →
DevOps

Volumes 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 tests

TDD 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 logiciels

Tests 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 SQL

Explication 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 SQL

Instruction 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 logiciel

Qu'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 logiciel

Boucle 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 logiciel

Gé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 artificielle

Que 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 →
DevOps

Dé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 tests

Tests 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 logiciels

Tests 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 logiciels

Scé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 SQL

Optimisation 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 SQL

SQL 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 logiciel

Tutoriel 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 logiciel

Gestion 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 logiciel

Classes 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 artificielle

Qu'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 →
DevOps

Commandes 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 tests

Selenium 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 logiciels

Partitionnement 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 logiciels

Gravité 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 SQL

Tutoriel 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 SQL

Transactions 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 logiciel

Aide-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 logiciel

Les 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 logiciel

Tutoriel 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 artificielle

Qu’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 →
DevOps

Tutoriel 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 →
DevOps

Docker 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 tests

Tutoriel 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 logiciels

Cycle 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 logiciel

Git 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 logiciel

List 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 SQL

Jointures 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 →