Si vous avez déjà eu besoin d'un faux point de terminaison API qui renvoie un corps JSON, un code de statut et des en-têtes spécifiques sans avoir à configurer un serveur, vous avez probablement cherché Mocky. Ce guide explique ce qu'est Mocky, comment l'utiliser et quand il ne suffira plus à vos besoins. Si vous souhaitez d'abord avoir une vue d'ensemble, notre tour d'horizon des outils de simulation d'API en ligne comparés couvre le domaine, et le référentiel open source de Mocky confirme les bases.
Qu'est-ce que Mocky ?
Mocky est un service web gratuit et open source permettant de générer des réponses HTTP personnalisées. Vous concevez une réponse dans votre navigateur, Mocky vous donne une URL unique, et toute requête à cette URL renvoie exactement ce que vous avez défini. Il n'y a pas de backend à écrire ni de serveur à héberger.
Il a été créé par Julien Lafont et publié sous la licence Apache 2.0. La version hébergée est disponible sur mocky.io, et comme le code est public, vous pouvez également l'auto-héberger si vous préférez exécuter votre propre instance.
L'idée principale est simple. Vous "concevez une réponse derrière une URL". C'est tout le produit, et cette focalisation est sa plus grande force.
Ce que vous pouvez configurer
Mocky vous permet de définir les parties d'une réponse HTTP qui sont importantes pour les tests clients :
- Code de statut, pour que vous puissiez renvoyer un
200, un404, ou un500sur demande. - Corps de la réponse, généralement JSON, mais toute charge utile textuelle fonctionne.
- En-têtes HTTP, y compris le type de contenu et les en-têtes personnalisés.
- Un délai de réponse, pour simuler un réseau lent ou un système amont qui lag.
Une fois sauvegardé, Mocky stocke la réponse et vous donne une URL permanente. Vous collez cette URL dans votre code frontal, votre test ou votre client HTTP, et vous avez terminé.
Un exemple rapide
Disons que votre backend n'est pas prêt, mais que votre frontend a besoin d'un objet utilisateur à afficher. Vous ouvririez le concepteur Mocky, définiriez le statut à 200, définiriez Content-Type: application/json, et colleriez un corps comme ceci :
{
"id": 42,
"name": "Ada Lovelace",
"role": "admin"
}
Mocky renvoie une URL telle que https://run.mocky.io/v3/<some-id>. Pointez votre application vers elle, et chaque requête récupérera cet utilisateur. Pour une vue plus large de ce modèle, consultez notre explication sur comment simuler des API en ligne sans configurer de serveur.
Quand Mocky est le bon choix
Mocky excelle lorsque vos besoins sont modestes et ponctuels :
- Vous voulez une seule réponse statique, rapide, sans compte.
- Vous partagez une charge utile fixe avec un coéquipier ou via un ticket de support.
- Vous reproduisez un cas d'erreur, comme une réponse d'erreur interne 500, pour un rapport de bug.
- Vous n'avez pas besoin que la réponse change en fonction de la requête.
Pour ces tâches, Mocky est difficile à battre. Il est gratuit, il se charge dans un navigateur, et vous pouvez avoir une URL fonctionnelle en moins d'une minute. Ne sur-ingénieriez pas un problème de cette taille.
Quand Mocky commence à poser problème
La même simplicité qui fait la force de Mocky le limite aussi. Chaque URL Mocky est une réponse fixe unique. À mesure que votre projet grandit, ce modèle devient insuffisant de manière prévisible.
- Pas de données dynamiques. Chaque appelant reçoit le même corps. Vous ne pouvez pas renvoyer un utilisateur différent pour
/users/1versus/users/2, et vous ne pouvez pas générer des données réalistes et variées. - Pas de correspondance de requêtes. Mocky ne se base pas sur les paramètres de requête, les valeurs de chemin ou les corps de requête. Une URL, une réponse.
- Organisation lâche. Une vraie API a des dizaines de points de terminaison. Les gérer comme un tas de liens Mocky séparés devient rapidement désordonné.
- Collaboration limitée. Il n'y a pas d'espace de travail partagé, pas de versionnement et pas de permissions d'équipe autour de vos mocks.
- Pas de lien de schéma. Votre mock et votre spécification OpenAPI vivent dans des endroits différents, ils finissent donc par se désynchroniser.
Lorsque vous rencontrez deux ou trois de ces problèmes, vous avez dépassé les capacités d'un outil à réponse unique. C'est le moment de passer à une plateforme de simulation complète. Si vous évaluez le compromis budgétaire, notre guide des serveurs de simulation d'API gratuits et peu coûteux présente les options.
Un déclencheur courant est l'équipe front-end. Un développeur simule l'objet utilisateur, un autre simule la liste de commandes, un troisième simule le flux d'authentification. Avec Mocky, ce sont trois liens sans rapport, sans URL de base partagée et sans moyen de changer d'environnement. Avec un vrai serveur de simulation, ce sont trois points de terminaison dans un seul projet qui répondent tous sous un hôte unique, et vous pouvez basculer entre les données de staging et de production en un seul endroit.
La meilleure alternative à Mocky : Apidog
Apidog conserve la meilleure caractéristique de Mocky, une réponse personnalisée derrière une URL partageable, puis ajoute ce que Mocky ne propose pas : la persistance sur plusieurs points de terminaison, des données pilotées par schéma, des réponses dynamiques et la collaboration en équipe. Vous concevez des points de terminaison, et Apidog génère une URL de simulation hébergée qui renvoie des codes de statut, des en-têtes et des corps JSON personnalisés, tout comme Mocky, mais liés à la conception réelle de votre API.
Voici la différence honnête. Mocky répond à la question "donnez-moi une réponse fixe, gratuite, tout de suite". Apidog répond à la question "donnez-moi une simulation crédible d'une API complète qui évolue avec mon projet".
Quelques fonctionnalités supplémentaires d'Apidog par rapport au cas d'utilisation de Mocky :
- Simulation intelligente et données générées par l'IA. Au lieu de coder en dur un seul corps, Apidog peut déduire des valeurs réalistes à partir de vos noms de champs et de votre schéma, de sorte que `email` renvoie un e-mail et `createdAt` renvoie une date.
- Support de Faker.js. Vous pouvez brancher Faker.js pour générer des données de simulation dynamiques pour des charges utiles variées et réalistes à chaque appel.
- Règles de simulation avancées. Renvoyez des réponses différentes en fonction des paramètres de requête ou du contenu de la requête, ce que la correspondance de requête de Mocky ne peut pas faire.
- Simulation axée sur le schéma. Votre simulation est générée à partir de votre conception OpenAPI, de sorte que les deux restent synchronisées.
- Espaces de travail d'équipe. Les simulations vivent dans un projet partagé avec un contrôle de version et une synchronisation en temps réel, et non dispersées sur des liens ponctuels.
Vous obtenez toujours la partie simple. Besoin d'un seul point de terminaison qui renvoie un 200 avec un corps JSON fixe derrière une URL ? Apidog le fait aussi, et vous pouvez le partager avec votre équipe en un seul clic.
Mocky vs Apidog en un coup d'œil
| Capacité | Mocky | Apidog |
|---|---|---|
| Statut, en-têtes, corps personnalisés derrière une URL | Oui | Oui |
| Gratuit pour commencer, pas de configuration | Oui | Oui (plan gratuit) |
| Réponse statique unique | Oui | Oui |
| Données dynamiques (Faker.js, simulation intelligente) | Non | Oui |
| Correspondance de requêtes / règles conditionnelles | Non | Oui |
| Plusieurs points de terminaison dans un seul projet | Non | Oui |
| Simulations pilotées par schéma (OpenAPI) | Non | Oui |
| Espace de travail d'équipe + versionnement | Non | Oui |
| Option d'auto-hébergement | Oui (open source) | Options Cloud + auto-hébergement |
Si vous souhaitez comparer plus de concurrents côte à côte, notre liste des meilleurs outils de simulation d'API et notre tour d'horizon des outils de simulation de points de terminaison REST approfondissent le sujet.
Comment remplacer une URL Mocky dans Apidog
Passer d'un simple lien Mocky est rapide :
- Téléchargez Apidog et créez un projet.
- Ajoutez un point de terminaison, par exemple
GET /users/42. - Définissez la réponse : définissez le code de statut, ajoutez des en-têtes et écrivez le corps JSON, les mêmes champs que vous auriez tapés dans Mocky.
- Activez la simulation. Apidog génère une URL de simulation hébergée pour ce point de terminaison.
- Pointez votre front-end ou votre test vers la nouvelle URL.
À partir de là, vous pouvez ajouter les extras, les données dynamiques, les règles conditionnelles, plus de points de terminaison, chaque fois que vous en avez besoin. Vous n'êtes pas obligé d'utiliser les fonctionnalités avancées dès le premier jour.
La migration est rarement effectuée en une seule fois. La plupart des équipes conservent leurs liens Mocky existants tout en reconstruisant les points de terminaison importants dans Apidog, puis retirent les anciennes URL une fois que le projet est regroupé. Étant donné qu'Apidog peut lire un fichier OpenAPI, si vous avez déjà une spécification, vous pouvez l'importer et obtenir des URL de simulation pour chaque point de terminaison en une seule fois, au lieu de recréer chaque réponse à la main.
Questions fréquemment posées
Mocky est-il gratuit ?
Oui. Mocky est gratuit et open source sous la licence Apache 2.0, et vous n'avez pas besoin de compte pour créer une simulation. Les réponses sont stockées côté serveur, de sorte que l'URL que vous obtenez reste active. Si vous avez besoin de plus d'une simple réponse fixe, une plateforme plus complète comme Apidog vous offre un niveau gratuit avec des données dynamiques et des fonctionnalités d'équipe.
Quelle est la différence entre mocky.io et un serveur de simulation ?
Une URL Mocky est une réponse pré-enregistrée. Un serveur de simulation simule une API entière, avec de nombreux points de terminaison, une correspondance de requêtes et des données qui peuvent changer par requête. Si vous débutez avec le concept, notre explication sur ce qu'est une API de simulation l'explique depuis le début.
Puis-je renvoyer un code de statut et des en-têtes personnalisés avec Mocky ?
Oui. C'est exactement à cela que sert Mocky. Vous définissez le code de statut, ajoutez les en-têtes que vous souhaitez, rédigez le corps, et Mocky sert tout cela à partir d'une seule URL. La limite est que c'est toujours la même réponse, quelle que soit la requête.
Quand devrais-je passer de Mocky à une plateforme de simulation complète ?
Passez à une autre solution lorsque vous avez besoin de plus d'une réponse fixe : des données dynamiques ou réalistes, des réponses conditionnelles, plusieurs points de terminaison organisés ensemble, ou un espace de travail partagé pour votre équipe. Jusque-là, la simplicité de Mocky est une fonctionnalité, pas un défaut.
En résumé
Mocky est un moyen propre et gratuit de placer une réponse HTTP personnalisée derrière une URL, et pour les besoins rapides et statiques, c'est le bon outil. Dès que vous avez besoin de données dynamiques, de correspondance de requêtes, de nombreux points de terminaison ou de collaboration d'équipe, ce modèle à réponse unique devient insuffisant.
C'est là qu'Apidog prend le relais. Il couvre le même travail de "concevoir une réponse derrière une URL", puis évolue vers une simulation collaborative, dynamique et pilotée par schéma à mesure que votre API grandit. Téléchargez Apidog pour créer gratuitement votre première URL de simulation et la conserver à mesure que votre projet prend de l'ampleur.