# Testeur de mutation de contrat API Applique des mutations semantiques aux champs OpenAPI et peut les envoyer a un backend reel pour mesurer la validation defensive > Page canonique: https://elysiatools.com/fr/tools/api-contract-mutation-tester - **Catégorie:** Development - **Mots-clés:** openapi, mutation, api, validation, contrat ## Présentation Collez un document OpenAPI 3.x. Loutil derive dabord des requetes valides pour chaque operation, puis transforme certains champs en variantes risquées: suppression dun champ requis, nombre negatif, enum invalide, chaine composee despaces ou charge speciale. Mode demploi : - Specification OpenAPI : collez YAML ou JSON - URL de base : laissez vide pour un plan hors ligne, ou pointez vers un backend reel - Executer les mutations : envoie vraiment les requetes mutees - En-tete dautorisation : accepte par exemple Bearer \- Mutations par champ : limite le nombre de variantes generees par champ - Delai de requete : fixe la duree max dune requete Lecture du resultat : - defended : le backend a rejete la mutation - accepted : le backend a quand meme repondu avec succes - documented : le code observe existe dans les responses OpenAPI ## Entrées - **Specification OpenAPI** (textarea): Paste an OpenAPI 3.x YAML or JSON document here... - **URL de base** (text): https://api.example.com - **Executer les mutations** (checkbox) - **En-tete dautorisation** (text): Bearer - **Mutations par champ** (number) - **Delai de requete (ms)** (number) ## Quand l'utiliser - Lors de l'audit de sécurité d'une API pour identifier les failles de validation des données entrantes. - Avant le déploiement d'une nouvelle version de votre contrat OpenAPI pour s'assurer que les règles de validation sont correctement implémentées côté serveur. - Pour automatiser les tests de robustesse (fuzzing sémantique) sur des endpoints spécifiques sans écrire de scripts manuels. ## Fonctionnement - Collez votre spécification OpenAPI 3.x (au format YAML ou JSON) dans le champ dédié. - L'outil analyse les opérations documentées et génère des requêtes de base valides, puis crée des mutations pour chaque champ (valeurs négatives, enums invalides, etc.). - Si vous renseignez une URL de base et activez l'exécution, l'outil envoie réellement les requêtes mutées au backend en utilisant l'en-tête d'autorisation fourni. - Consultez le rapport final pour voir quelles mutations ont été défendues (rejetées par le serveur) ou acceptées à tort, et si les codes de retour sont documentés. ## Cas d'usage - Vérification de la gestion des erreurs sur un endpoint d'inscription utilisateur (ex: âge négatif, email sans format valide). - Test de résilience d'une API financière face à des montants de transaction inattendus ou des types de devises non répertoriés. - Validation de la conformité stricte entre l'implémentation du backend et le contrat OpenAPI fourni aux clients. ## Questions fréquentes ### Quels formats de spécification sont pris en charge ? L'outil accepte les documents OpenAPI 3.x au format YAML ou JSON. ### Est-il obligatoire d'envoyer les requêtes à un vrai serveur ? Non, si vous laissez l'URL de base vide, l'outil générera uniquement un plan de mutation hors ligne pour vous montrer les requêtes qui seraient testées. ### Que signifie le statut 'defended' dans les résultats ? Cela indique que votre backend a correctement identifié la requête mutée comme invalide et l'a rejetée avec un code d'erreur approprié. ### Comment limiter le nombre de requêtes générées ? Vous pouvez ajuster le paramètre 'Mutations par champ' (entre 1 et 6) pour contrôler le volume de variantes créées pour chaque paramètre. ### Puis-je tester des API nécessitant une authentification ? Oui, vous pouvez fournir un jeton dans le champ 'En-tête d'autorisation' (par exemple, 'Bearer ') pour authentifier les requêtes mutées. ## Outils associés - [Sync de palette Tailwind](https://elysiatools.com/fr/tools/tailwind-color-palette-sync): Entrez des HEX, choisissez le schéma de noms (échelle 50–950 / nom unique / imbrication) et générez le fragment theme.extend.colors de tailwind.config.ts avec les niveaux WCAG AA/AAA. Dark mode optionnel. - [Testeur de stress de contrat API](https://elysiatools.com/fr/tools/api-contract-stress-tester): Genere des tests de valeurs limites depuis OpenAPI 3.x et peut les envoyer a un backend reel pour reperer les ecarts de contrat. - [Convertisseur cURL vers Go (net/http)](https://elysiatools.com/fr/tools/curl-to-go): Convertit une commande cURL en un extrait de code Go net/http avec http.NewRequest, en-têtes et corps - [Convertisseur cURL vers HAR](https://elysiatools.com/fr/tools/curl-to-har-converter): Convertit une commande cURL en entrée de requête HAR 1.2 portable. - [Convertisseur cURL vers JavaScript (axios)](https://elysiatools.com/fr/tools/curl-to-js-axios): Convertit une commande cURL en un extrait de code JavaScript axios avec objet de config, en-têtes et données - [Convertisseur cURL vers JavaScript (fetch)](https://elysiatools.com/fr/tools/curl-to-js-fetch): Convertit une commande cURL en un extrait de code JavaScript fetch() avec en-têtes, corps et méthode - [Convertisseur cURL vers PHP (cURL)](https://elysiatools.com/fr/tools/curl-to-php): Convertit une commande cURL en un extrait de code PHP cURL avec curl_setopt, en-têtes et champs POST - [Convertisseur cURL vers Python (requests)](https://elysiatools.com/fr/tools/curl-to-python): Convertit une commande cURL en un extrait de code Python requests avec en-têtes, données et méthode ## Exemples - [Collections Postman - Tests API](https://elysiatools.com/fr/samples/postman-collections): Exemples complets de collections Postman incluant tests API, scripts d'automatisation, variables d'environnement, serveurs mock et patterns de test avancés pour REST APIs - [Exemples de Traitement d'Images Web Python](https://elysiatools.com/fr/samples/web-image-processing-python): Exemples de traitement d'images Web Python utilisant PIL/Pillow incluant la lecture, l'enregistrement, le redimensionnement et la conversion de format - [Exemples OpenAI API](https://elysiatools.com/fr/samples/openai): Exemples complets de l'API OpenAI incluant les modèles GPT, la génération d'images DALL-E, le traitement audio Whisper et les appels de fonctions - [API Graphique WebGPU](https://elysiatools.com/fr/samples/webgpu): API graphique moderne pour les graphiques 3D haute performance et le calcul GPU dans le navigateur ## Contenu associé - [Définition de contrats API, validation de schémas et tests de changements](https://elysiatools.com/fr/hubs/api-contract-testing): Définissez un contrat API, validez schémas et charges capturées, détectez les risques de compatibilité et consignez l'acceptation. - [Versionnage d API et revue des changements cassants](https://elysiatools.com/fr/hubs/api-versioning-breaking-change-review): Comparez les versions d API, planifiez la migration et acceptez la compatibilite avant la release. Les outils ne remplacent ni le deploiement reel ni la supervision. - [Outils de validation JSON Schema et de contrats API](https://elysiatools.com/fr/hubs/json-validate): Comparez la validation JSON Schema, les contrôles de réponse OpenAPI, les tests de mutation, les tests de charge contractuels et la détection de changements cassants dans un hub unique. - [Workflow utilitaire OpenAPI](https://elysiatools.com/fr/hubs/openapi-utility): Generez types et documentation OpenAPI, verifiez les ruptures, validez les reponses et renforcez le contrat par stress et mutation tests.