Si vous cherchez « mockserver », vous parlez peut-être soit du concept générique de serveur de maquette, soit du projet open-source MockServer. Cet article se concentre sur le second : un mock server et proxy HTTP(S) basé sur Java, utile pour les tests automatisés, mais parfois lourd à configurer. Si votre objectif est de simuler rapidement une API, vous pouvez aussi télécharger Apidog. Pour les bases du concept, consultez aussi notre guide sur ce qu’est une API de maquette.
Qu’est-ce que MockServer ?
MockServer est un serveur de maquette et un proxy HTTP(S) conçu pour les tests. Vous définissez des attentes : des règles qui correspondent aux requêtes entrantes, puis retournent une réponse, transfèrent la requête, exécutent un callback ou injectent une défaillance.
Vous pouvez l’exécuter de plusieurs façons :
- comme processus autonome ;
- dans Docker ;
- via un plugin Maven ;
- directement dans des tests JVM ;
- avec des clients Java, JavaScript, Python ou Ruby.
Un cas typique consiste à écrire une attente qui intercepte une requête et retourne une réponse fixe :
{
"httpRequest": {
"method": "GET",
"path": "/users/123"
},
"httpResponse": {
"statusCode": 200,
"headers": {
"Content-Type": ["application/json"]
},
"body": {
"id": 123,
"name": "Alice",
"email": "alice@example.com"
}
}
}
MockServer peut aussi :
- faire correspondre les requêtes par méthode, chemin, headers, query params ou body ;
- renvoyer des réponses simulées ;
- proxifier du trafic réel si aucune attente ne correspond ;
- enregistrer du trafic live et le rejouer ;
- injecter des latences ou des connexions interrompues pour du chaos testing ;
- fonctionner avec HTTP/1.1, HTTP/2, gRPC, WebSockets et TCP ;
- s’intégrer à JUnit, Spring et aux pipelines CI.
Le projet est open source sur GitHub. Les versions récentes incluent aussi des capacités liées aux API de complétion de chat LLM et un serveur MCP pour les assistants de codage IA.
En pratique, MockServer est très pertinent si vous travaillez déjà dans un environnement Java et que vous voulez intégrer vos mocks au cycle de vie de vos tests.
Là où MockServer devient moins pratique
MockServer est puissant, mais cette puissance ajoute de la configuration. Les frictions apparaissent surtout dans les équipes qui veulent aller vite sans maintenir une pile JVM.
1. Dépendance à Java ou Docker
MockServer 6.x nécessite Java 17+. Si votre équipe travaille principalement en frontend, QA ou Node.js, vous ajoutez un runtime ou un conteneur uniquement pour simuler quelques endpoints.
Exemple de lancement avec Docker :
docker run -d --rm \
-p 1080:1080 \
mockserver/mockserver
C’est simple pour un développeur backend, mais cela reste une dépendance supplémentaire pour une équipe qui veut juste une API simulée disponible immédiatement.
2. Configuration répétitive
Chaque comportement simulé doit être défini sous forme d’attente. Pour une réponse simple, c’est acceptable. Pour plusieurs statuts HTTP, payloads réalistes, erreurs métier ou scénarios conditionnels, la configuration grossit vite.
Exemple :
{
"httpRequest": {
"method": "POST",
"path": "/orders",
"body": {
"type": "JSON",
"json": {
"product_id": 42,
"quantity": 2
}
}
},
"httpResponse": {
"statusCode": 201,
"body": {
"id": "ord_123",
"status": "created"
}
}
}
Répétez cela pour les cas 400, 401, 404, 500, et vous obtenez rapidement beaucoup de JSON à maintenir.
3. Pas de couche visuelle intégrée
MockServer n’est pas pensé comme un outil visuel de conception d’API. Vous configurez les attentes, redémarrez si nécessaire, puis vérifiez les logs. Pour des profils non-Java ou des équipes produit/QA, la courbe d’apprentissage peut être importante.
4. Données statiques par défaut
MockServer retourne ce que vous écrivez. Si vous voulez des emails, dates, identifiants, noms ou données variables réalistes, vous devez ajouter du code, des templates ou des bibliothèques externes.
Cela ne rend pas MockServer mauvais. Cela en fait un outil spécialisé, surtout adapté aux tests d’intégration JVM. Si vous cherchez une approche plus rapide, visuelle ou pilotée par OpenAPI, les alternatives suivantes sont souvent plus efficaces.
Les meilleures alternatives à MockServer en 2026
1. Apidog : le meilleur choix global
Apidog est une plateforme API tout-en-un pour concevoir, tester, documenter et simuler des API dans un même espace de travail.
Pour remplacer MockServer, l’intérêt principal est clair : vous n’avez pas besoin de Java, de Docker ou d’un DSL d’attentes. Vous partez d’un schéma OpenAPI ou vous créez vos endpoints visuellement, puis Apidog génère une API mock fonctionnelle.
Workflow typique avec Apidog
- Importez un fichier OpenAPI ou créez une API dans l’interface.
- Définissez les endpoints, paramètres et modèles de réponse.
- Activez le mock server.
- Partagez l’URL de mock avec les développeurs frontend, QA ou partenaires.
- Utilisez la même source pour les tests et la documentation.
Le mocking intelligent lit les noms et types de champs pour générer des données réalistes. Par exemple :
{
"id": 123,
"name": "Jean Dupont",
"email": "jean.dupont@example.com",
"created_at": "2026-06-24T10:30:00Z"
}
Un champ email produit un email, created_at produit un horodatage, et ainsi de suite, grâce à une génération de données de type Faker. Vous pouvez consulter ce guide sur Faker.js et son utilisation dans Apidog pour comprendre cette logique.
Pourquoi choisir Apidog plutôt que MockServer ?
- Pas de Java ni de Docker obligatoire : les mocks viennent du schéma ou de l’interface.
- Approche visuelle : vous créez et modifiez les réponses sans écrire d’attentes JSON à la main.
- Données réalistes : génération automatique à partir des noms et types de champs.
- Scénarios de réponse : utile pour simuler succès, erreurs métier ou statuts HTTP différents.
- Cloud ou auto-hébergé : partage rapide via le cloud ou déploiement contrôlé selon les besoins. Pour comparer les options, consultez notre guide des serveurs de maquettes API auto-hébergés.
- Cycle de vie complet : conception, mocking, tests et documentation restent synchronisés.
Le compromis : MockServer reste plus granulaire pour les tests d’intégration JVM bas niveau, en particulier lorsque vous voulez piloter le mock directement depuis du code Java. Apidog est plus adapté aux équipes qui veulent aller vite, partager facilement et garder le mock aligné avec le contrat API.
2. WireMock
WireMock est l’autre référence côté JVM. Comme MockServer, il repose sur la correspondance de requêtes et des stubs. Il prend en charge l’enregistrement, la relecture, l’exécution autonome et l’intégration dans les tests.
Exemple de stub WireMock :
{
"request": {
"method": "GET",
"url": "/users/123"
},
"response": {
"status": 200,
"jsonBody": {
"id": 123,
"name": "Alice"
},
"headers": {
"Content-Type": "application/json"
}
}
}
Choisissez WireMock si :
- vous êtes déjà sur Java ;
- vous voulez intégrer vos mocks dans des tests JUnit ;
- vous préférez son API et son écosystème à ceux de MockServer ;
- vous avez besoin d’enregistrement/relecture dans un contexte JVM.
Ses limites sont proches de celles de MockServer : configuration manuelle, dépendance Java ou Docker, et absence de concepteur visuel complet dans l’édition open-source. Pour aller plus loin, consultez notre guide des alternatives à WireMock.
3. Mockoon
Mockoon est une application de bureau gratuite et open-source. Elle est pensée pour créer rapidement des API mock via une interface graphique, sans écrire de code ni installer de runtime serveur complexe.
Un workflow simple :
- Créez un nouvel environnement.
- Ajoutez une route, par exemple
GET /users. - Définissez une réponse JSON.
- Lancez le serveur local.
- Branchez votre frontend sur l’URL locale.
Exemple de réponse :
[
{
"id": 1,
"name": "Alice",
"role": "admin"
},
{
"id": 2,
"name": "Mehdi",
"role": "user"
}
]
Mockoon est très pratique pour :
- prototyper une interface frontend ;
- travailler localement sans backend ;
- créer rapidement un faux endpoint ;
- éviter Java, Docker ou une configuration CI.
Sa limite principale est le travail en équipe et la gestion schema-first. Pour un usage local individuel, il est excellent. Pour un cycle API complet avec conception, documentation, tests et partage, une plateforme plus large sera plus adaptée. Notre comparaison des alternatives à Mockoon détaille ces cas.
4. Prism par Stoplight
Prism est un mock server open-source basé sur OpenAPI. Vous lui fournissez une spécification, et il sert des réponses conformes au contrat.
Exemple d’utilisation :
npx @stoplight/prism-cli mock openapi.yaml
Si votre fichier OpenAPI contient :
paths:
/users/{id}:
get:
responses:
"200":
description: User found
content:
application/json:
schema:
type: object
properties:
id:
type: integer
email:
type: string
Prism peut exposer un endpoint mock conforme à ce contrat.
Choisissez Prism si :
- votre spécification OpenAPI est la source de vérité ;
- vous voulez un mock server léger en ligne de commande ;
- vous voulez valider les requêtes et réponses par rapport au schéma ;
- vous n’avez pas besoin d’une interface graphique.
Prism est particulièrement utile dans les workflows de mocking basés sur le schéma. En revanche, il ne couvre pas tout le cycle conception-test-documentation.
5. Beeceptor
Beeceptor est une solution hébergée dans le navigateur. Vous créez un endpoint mock en quelques secondes, sans installation locale.
C’est utile pour :
- tester rapidement un webhook ;
- partager un endpoint de démo ;
- capturer des requêtes entrantes ;
- simuler une API sans rien installer ;
- dépanner une intégration externe.
Sa force est aussi sa limite : Beeceptor est cloud-first. Les quotas gratuits, le travail hors ligne et les contraintes réseau internes peuvent devenir bloquants. Pour un serveur de maquette léger pour une API RESTful, il reste une option pratique lorsque la simplicité prime sur le contrôle.
Comparaison rapide
| Outil | Configuration | Interface graphique | Génération de données | Auto-hébergé | Idéal pour |
|---|---|---|---|---|---|
| MockServer | Java 17+ / Docker | Non | Manuelle | Oui | Tests d’intégration JVM/CI |
| Apidog | Application de bureau, pas de runtime Java | Oui | Intelligente / Faker | Cloud + auto-hébergé | Équipes voulant conception + mock + test |
| WireMock | Java / Docker | Limitée | Manuelle | Oui | Équipes JVM avec besoin d’enregistrement/relecture |
| Mockoon | Application de bureau | Oui | Templating | Local | Développeurs frontend solo |
| Prism | CLI Node | Non | À partir d’OpenAPI | Oui | Mocking schema-first |
| Beeceptor | Navigateur, hébergé | Oui | Templating | Non, cloud | Démos rapides et webhooks |
Pour comparer plus d’options, consultez cette comparaison des outils de mocking API en ligne.
Comment choisir votre mock server
Ne choisissez pas uniquement sur la liste de fonctionnalités. Choisissez selon votre contrainte principale.
Restez sur MockServer si
- votre projet est déjà en Java ;
- vos tests tournent avec JUnit, Spring ou Maven ;
- vous voulez piloter les mocks directement depuis le code ;
- vous avez besoin d’un proxy HTTP(S) programmable ;
- vous acceptez d’écrire les attentes manuellement.
Choisissez Apidog si
- vous voulez créer des mocks sans Java ni Docker ;
- votre API est décrite par OpenAPI ;
- vous voulez générer des données réalistes automatiquement ;
- votre équipe frontend, backend et QA doit partager les mêmes endpoints ;
- vous voulez garder conception, documentation, tests et mocks synchronisés.
Choisissez WireMock si
- vous voulez rester dans l’écosystème JVM ;
- vous avez besoin d’une alternative proche de MockServer ;
- l’enregistrement/relecture est important dans vos tests.
Choisissez Mockoon si
- vous voulez une application locale gratuite ;
- vous travaillez principalement côté frontend ;
- vous avez besoin d’un mock rapide pour développer une interface.
Choisissez Prism si
- votre fichier OpenAPI est votre contrat principal ;
- vous aimez les outils CLI ;
- vous voulez un mock strictement aligné avec le schéma.
Choisissez Beeceptor si
- vous avez besoin d’un endpoint jetable ;
- vous testez un webhook ;
- vous voulez démarrer sans installation.
La question clé est donc : voulez-vous seulement un mock server, ou voulez-vous une source unique de vérité pour concevoir, tester, documenter et simuler votre API ? Si vos endpoints évoluent souvent, maintenir la maquette alignée avec le contrat devient plus important que la granularité du moteur de mocking.
Foire aux questions
MockServer est-il gratuit ?
Oui. MockServer est open source et gratuit à auto-héberger. Le coût principal n’est pas financier, mais opérationnel : vous devez maintenir Java 17+ ou Docker, puis écrire et maintenir les attentes.
Des outils comme Apidog proposent aussi un niveau gratuit, avec une approche différente : interface graphique, schéma OpenAPI et génération automatique de données au lieu d’une configuration principalement basée sur du code.
Quelle est la différence entre MockServer et Apidog pour le mocking ?
MockServer est un mock server et proxy basé sur Java. Vous le configurez avec du code ou des attentes JSON. Il est très adapté aux tests JVM et aux scénarios bas niveau.
Apidog génère des mocks à partir d’un schéma OpenAPI ou d’une interface visuelle. Il ajoute la génération de données réalistes, le partage cloud et l’intégration avec la documentation et les tests.
En résumé :
- MockServer privilégie le contrôle programmable.
- Apidog privilégie la rapidité, la collaboration et la cohérence avec le contrat API.
Notre comparaison des serveurs de maquettes Postman vs Apidog illustre le même compromis entre interface graphique et configuration manuelle.
Puis-je simuler une API sans écrire de Java ?
Oui. Vous pouvez éviter Java avec plusieurs outils :
- Apidog : interface graphique et mocks basés sur le schéma ;
- Mockoon : application locale ;
- Prism : CLI basée sur OpenAPI ;
- Beeceptor : endpoint mock hébergé dans le navigateur.
Si votre objectif est simplement de fournir une fausse API à un frontend, vous n’avez pas besoin d’un runtime JVM.
MockServer supporte-t-il OpenAPI ?
MockServer peut initialiser des attentes à partir d’une spécification OpenAPI. Cela permet de générer une partie de la configuration depuis un contrat existant.
Cependant, il reste moins centré sur OpenAPI que des outils comme Prism ou Apidog, qui traitent le schéma comme source principale et gardent les réponses alignées avec celui-ci.
Conclusion
MockServer est un outil solide pour les équipes Java qui veulent des mocks programmables, un proxy HTTP(S), de l’enregistrement de trafic et une intégration poussée dans les tests JVM ou CI.
Ses limites apparaissent lorsque l’équipe veut aller vite sans maintenir Java, Docker ou un DSL d’attentes : beaucoup de configuration, pas d’interface visuelle intégrée et des données statiques par défaut.
Si vous restez dans la JVM, MockServer ou WireMock sont de bons choix. Si vous voulez un outil local simple, Mockoon est efficace. Si votre contrat OpenAPI est central, Prism est pertinent. Si vous avez besoin d’un endpoint jetable, Beeceptor fait le travail.
Pour la plupart des équipes qui veulent des mocks réalistes sans surcharge de runtime, Apidog est l’option la plus complète : conception, tests, documentation et mocking dans un même espace. Importez votre schéma, activez le mock server et partagez une API simulée en quelques secondes.






Top comments (0)