Un outil de simulation d'API sans interface graphique (headless) crée une fausse version fonctionnelle de votre API à partir d'une spécification ou d'une configuration, puis l'exécute à partir de la ligne de commande sans fenêtre à traverser. C'est exactement ce dont vous avez besoin dans un pipeline CI, un conteneur Docker ou un script de développement frontal. Ce guide explique ce que signifie « headless » pour la simulation, présente les véritables options sans interface graphique (Prism, WireMock, Mockoon CLI) et explique la place d'Apidog. Si vous voulez d'abord comprendre le concept, commencez par ce qu'est une API de simulation.
Ce que « headless » signifie pour une API de simulation
Un serveur de simulation répond aux requêtes HTTP avec des réponses fausses mais réalistes, permettant à un frontal ou une suite de tests de fonctionner avant que le véritable backend n'existe. « Headless » signifie simplement que la simulation s'exécute sans interface graphique. Vous la démarrez avec une commande, la dirigez vers une spécification ou un fichier de données, et elle écoute sur un port.
Cela est important car les endroits où vous souhaitez le plus une simulation sont des endroits sans écran :
- Un job CI qui a besoin d'un backend stable pour effectuer des tests.
- Un conteneur Docker dans une pile
docker-compose. - Le terminal d'un coéquipier qui souhaite que la simulation s'exécute en arrière-plan.
- Un environnement de prévisualisation éphémère créé par demande d'extraction (pull request).
Un outil de simulation avec interface graphique est parfait pour concevoir des réponses sur votre ordinateur portable. Mais dès que vous avez besoin de cette simulation dans un pipeline, vous avez besoin d'un mode sans interface graphique : un flag CLI, une image Docker ou une URL hébergée que tout job peut interroger.
Simulations basées sur la spécification vs. basées sur la configuration
Les outils de simulation sans interface graphique se divisent en deux catégories, et la différence façonne l'ensemble de votre flux de travail.
Les outils basés sur la spécification lisent votre document OpenAPI et servent les réponses directement à partir de celui-ci. Le schéma est la source de vérité. Ajoutez un champ à la spécification, et la simulation le renvoie. Cela garantit que la simulation reste fidèle au contrat car elle ne peut pas s'en éloigner.
Les outils basés sur la configuration stockent les réponses dans leur propre format (fichiers JSON, stubs enregistrés, règles écrites à la main). Ils sont flexibles et adaptés aux cas limites non couverts par la spécification, mais vous maintenez cette configuration manuellement, et elle peut s'éloigner de l'API réelle.
La plupart des équipes préfèrent les simulations basées sur la spécification pour les cas standards et les surcharges basées sur la configuration pour les cas exceptionnels. Les meilleures configurations de simulation d'API prennent en charge les deux.
Les options de simulation sans interface graphique, en toute honnêteté
Voici les outils qui méritent d'être connus. Chacun fonctionne sans interface graphique et possède de réelles forces.
Prism (Stoplight)
Prism transforme un fichier OpenAPI 2/3 ou Postman Collection en un serveur de simulation à partir d'une seule commande :
prism mock openapi.yaml
Il écoute sur http://127.0.0.1:4010 par défaut. Par défaut, il renvoie des exemples statiques de votre spécification. Ajoutez -d (dynamique) et Prism génère des données aléatoires mais valides à partir du schéma, avec la prise en charge de Faker via l'extension x-faker. C'est un logiciel open source, léger et véritablement axé sur la spécification. Si votre contrat réside dans un seul fichier OpenAPI et que vous souhaitez une simulation purement CLI, Prism est un excellent choix.
WireMock
WireMock est un serveur de simulation HTTP mature, basé sur Java. Vous exécutez le fichier jar autonome :
java -jar wiremock-standalone-3.x.x.jar --port 9099
Son modèle principal est le stubbing : vous définissez des règles de correspondance des requêtes et les réponses qu'elles renvoient, via une API JSON ou des fichiers JSON. Il enregistre et rejoue également le trafic d'un service réel, ce qui est pratique lorsque vous n'avez pas de spécification mais que vous avez un backend fonctionnel à capturer. WireMock excelle pour la correspondance complexe des requêtes, les scénarios avec état et les piles basées sur JVM.
Mockoon CLI
Mockoon est une application de bureau avec une CLI associée pour une utilisation sans interface graphique. La CLI exécute les environnements de simulation que vous créez, sur des serveurs, en CI ou partout où vous ne pouvez pas ouvrir l'application de bureau :
mockoon-cli start --data ./environment.json --port 3000
Il fournit une image Docker officielle et une commande dockerize qui génère un Dockerfile pour une image de simulation autonome. Mockoon est basé sur la configuration (vous construisez des environnements dans l'interface graphique, puis les exécutez sans interface graphique), avec des modèles, des règles de réponse et un mode proxy. Un bon choix si vous aimez concevoir visuellement et déployer sans interface graphique.
Serveur de simulation Apidog
Apidog est une plateforme API tout-en-un, et son serveur de simulation est par défaut basé sur le schéma. Lorsque vous définissez ou importez une API, Apidog génère une simulation sans configuration supplémentaire. Son Smart Mock lit les noms de champs et les types pour produire des données réalistes : il reconnaît des éléments comme email, avatar, username, phone, date et IP, et les remplit avec des valeurs pertinentes au lieu de placeholders string. Pour un contrôle total, vous pouvez utiliser des expressions Faker.js comme {{$person.fullName}} ou {{$number.int(min=1,max=100)}}, ainsi que des règles de simulation personnalisées pour des conditions de requête spécifiques.
Pour une utilisation sans interface graphique, Apidog expose une URL de simulation Cloud (https://mock.apidog.com/...) que n'importe quel job CI ou coéquipier peut utiliser sans rien exécuter localement. Une simulation locale s'exécute également sur 127.0.0.1, et vous pouvez la lier à votre IP intranet afin que d'autres machines puissent y accéder. Parce que la simulation dérive du même projet qui contient la conception, la documentation et les tests de votre API, elle reste alignée avec le contrat au lieu de dériver vers un fichier de configuration distinct.
Comparaison
| Outil | Source de vérité | Exécution sans interface graphique | Données réalistes | Idéal pour |
|---|---|---|---|---|
| Prism | Fichier OpenAPI / Postman | prism mock spec.yaml |
Mode dynamique (-d) + x-faker |
Simulation CLI purement basée sur la spécification |
| WireMock | Règles de stub / enregistrements | Jar autonome | Templating des réponses | Correspondance complexe, piles JVM, enregistrement/relecture |
| Mockoon CLI | Environnements créés par l'interface graphique | mockoon-cli start + Docker |
Aides au templating | Conception visuelle, déploiement sans interface graphique |
| Apidog | Schéma d'API dans le projet | URL de simulation Cloud + serveur local | Smart Mock + Faker.js | Simulations basées sur le schéma liées à la conception, aux documents et aux tests |
Il n'y a pas de gagnant unique. Prism est le plus simple si votre API entière est un seul fichier OpenAPI. WireMock l'emporte sur la profondeur de correspondance des requêtes. Mockoon est excellent si vous préférez construire visuellement. Apidog convient aux équipes qui souhaitent que la simulation, le contrat, la documentation et les tests soient au même endroit afin qu'ils ne se désalignent pas. Pour un aperçu plus large, consultez notre récapitulatif des meilleurs outils de simulation d'API.
Exécuter une simulation sans interface graphique en CI
Le modèle est le même pour tous les outils. Vous démarrez la simulation, y dirigez vos tests, puis l'arrêtez.
Une simulation CLI basée sur la spécification ressemble à ceci dans une étape de pipeline :
# démarrer la simulation en arrière-plan
prism mock ./openapi.yaml &
MOCK_PID=$!
# exécuter vos tests frontend ou API contre http://127.0.0.1:4010
npm test
# nettoyer
kill $MOCK_PID
Avec Apidog, vous pouvez ignorer l'exécution de quoi que ce soit en dirigeant les tests vers l'URL de simulation Cloud, ou exécuter une simulation locale de la même manière. La simulation répond à partir de votre schéma actuel, donc lorsque le contrat change, la simulation change avec lui.
L'étape suivante naturelle est de tester cette simulation depuis la ligne de commande. La CLI d'Apidog (apidog-cli) est elle-même sans interface graphique : apidog run exécute vos scénarios de test en CI, prend en charge les exécutions basées sur les données à partir de CSV ou JSON, et génère des rapports CLI, HTML ou JSON. Le guide tester une API REST depuis la ligne de commande montre le cycle complet, et le guide complet de la CLI couvre les flags. Si vous avez utilisé Newman, la comparaison Apidog CLI vs Postman CLI met en correspondance les concepts.
Simulations et agents de codage IA
Si vous écrivez du code avec Cursor, Claude ou VS Code, votre agent bénéficie de la connaissance du contrat d'API derrière une simulation. Le serveur Apidog MCP permet à un agent IA de lire directement vos spécifications d'API, afin qu'il puisse générer du code client qui correspond au schéma que votre simulation sert déjà. Cela permet de maintenir la sortie de l'agent et vos réponses de simulation alignées sur le même contrat.
Foire aux questions
Une simulation sans interface graphique est-elle la même chose qu'un serveur de simulation ?
Oui, avec un détail. Un serveur de simulation est tout processus qui répond aux requêtes avec de fausses réponses. « Headless » (sans interface graphique) spécifie qu'il s'exécute sans GUI, démarré par une commande ou hébergé à une URL, de sorte qu'il fonctionne en CI, Docker et dans des scripts. Chaque outil présenté ici peut fonctionner sans interface graphique.
Puis-je générer une simulation sans interface graphique à partir de ma spécification OpenAPI ?
Oui. Prism lit directement OpenAPI, et Apidog génère une simulation à partir du schéma de votre projet. Les simulations basées sur la spécification économisent des efforts et restent plus proches du contrat, car la simulation reflète ce que dit la spécification plutôt qu'une configuration maintenue séparément. Consultez notre guide de simulation d'API pour le flux de travail complet.
Comment les simulations sans interface graphique renvoient-elles des données réalistes au lieu de placeholders ?
Chaque outil possède un moteur de données. Le mode dynamique de Prism et x-faker génèrent des valeurs à partir du schéma. Le Smart Mock d'Apidog associe les noms de champs comme email ou phone à des valeurs pertinentes, et vous pouvez insérer des expressions Faker.js pour un contrôle plus fin. Sans l'une de ces fonctionnalités, les simulations ont tendance à renvoyer des chaînes vides et des zéros.
Dois-je exécuter un serveur, ou puis-je utiliser une URL de simulation hébergée ?
Les deux fonctionnent. WireMock, Prism et Mockoon CLI exécutent un processus que vous gérez. Apidog ajoute une URL de simulation Cloud hébergée que tout job CI ou coéquipier peut appeler sans configuration locale, ce qui supprime un élément mobile du pipeline.
Conclusion
Un outil de simulation d'API sans interface graphique fait la différence entre une simulation qui vous aide à naviguer localement et une qui s'exécute réellement dans votre pipeline. Prism, WireMock et Mockoon CLI le font tous très bien, chacun à sa manière. Si vous souhaitez que la simulation reste liée à la conception, à la documentation et aux tests de votre API au lieu de résider dans sa propre configuration qui dérive, Apidog conserve tout cela dans un seul projet, avec une simulation basée sur le schéma qui s'exécute localement ou depuis une URL hébergée. Téléchargez Apidog pour créer une simulation à partir de votre spécification et la cibler avec votre CI.