mockapi.dog

Guide d'API REST simulée

Créez gratuitement des endpoints d'API REST instantanés avec réponses personnalisées, codes de statut et fonctionnalités avancées. Sans inscription.

Premiers pas

La création d'un endpoint d'API REST simulé prend moins de 30 secondes. Suivez ces étapes simples :

  1. 1

    Visitez la page d'accueil

    Rendez-vous sur mockapi.dog et sélectionnez l'onglet « API REST ».

  2. 2

    Définissez le chemin et la méthode HTTP

    Saisissez le chemin de la ressource après l'URL générée (par exemple /api/users), puis sélectionnez GET, POST, PUT, PATCH ou DELETE.

  3. 3

    Rédigez votre réponse JSON

    Choisissez un code de statut et saisissez le JSON que l'endpoint doit renvoyer. L'éditeur valide le JSON pendant la saisie.

    {
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
}
  4. 4

    Configurez les délais et la simulation d'erreurs (facultatif)

    Ajoutez un délai de réponse, un taux d'erreur aléatoire ou une erreur déclenchée par un en-tête de requête.

  5. 5

    Validez la vérification et enregistrez

    Effectuez la vérification Turnstile, puis cliquez sur « Enregistrer l'endpoint simulé ». L'URL de votre endpoint est automatiquement copiée !

    https://abc123.mockapi.dog/api/users

Votre endpoint est immédiatement en ligne !

Pas de déploiement, pas d'attente. Commencez à faire des requêtes immédiatement depuis votre application, vos tests ou des outils comme Postman et curl.

Fonctionnalités principales

Méthodes HTTP

Prise en charge de toutes les méthodes HTTP standard pour correspondre à votre conception d'API.

  • GET - Récupérer des données
  • POST - Créer des ressources
  • PUT - Mise à jour complète
  • PATCH - Mise à jour partielle
  • DELETE - Supprimer des ressources

Codes de statut

Renvoyez n'importe quel code de statut HTTP pour tester les succès, les erreurs et les cas limites.

  • 200OK - Succès
  • 201Créé
  • 400Requête incorrecte
  • 401Non autorisé
  • 500Erreur serveur

Réponses JSON

Renvoyez n'importe quelle structure JSON valide — d'objets simples à des données imbriquées complexes.

  • Objets et tableaux
  • Structures imbriquées
  • Tableaux d'objets
  • Validation en temps réel
  • Content-Type approprié

Fonctionnalités avancées

Affinez vos endpoints simulés grâce à des fonctionnalités puissantes pour des scénarios de test réalistes.

Délais de réponse

Ajoutez un délai fixe de 10000 ms maximum avant l'envoi de la réponse, pour simuler un réseau lent ou un temps de traitement serveur.

Cas d'usage :

  • Tester les états de chargement de l'interface
  • Simuler des réseaux 3G/4G lents
  • Vérifier la gestion des timeouts
  • Vérifier les écrans squelettes

Exemples de délais :

500 ms - Rapide2000 ms - Normal5000 ms - Lent

Simulation d'erreurs

Définissez un pourcentage de requêtes qui renverront des erreurs. Idéal pour tester la gestion des erreurs et la logique de réessai.

Cas d'usage :

  • Tester les error boundaries
  • Vérifier les mécanismes de réessai
  • Vérifier les messages d'erreur
  • Valider l'interface de repli

Exemples de taux d'erreur :

10 % d'erreurs50 % d'erreurs100 % d'erreurs

Corps de la réponse d'erreur :

{
  "error": "Simulated error (10% error rate)",
  "triggeredBy": "random-error-rate"
}

Erreurs conditionnelles

Renvoyez une erreur uniquement lorsqu'une requête contient un en-tête avec la valeur exacte définie. Envoyez l'en-tête pour obtenir l'erreur, omettez-le sinon.

Exemples de cas d'usage :

  • Échec d'authentification :X-Test-Auth: expired renvoie 401 pour tester la redirection vers la connexion
  • Introuvable :X-Test-Error: missing renvoie 404 pour tester les états vides
  • Panne :X-Test-Error: down renvoie 503 pour tester l'interface de repli

Lorsqu'une requête correspond à l'en-tête, c'est l'erreur de l'en-tête qui est renvoyée, et non celle du taux d'erreur aléatoire.

Corps de la réponse d'erreur :

{
  "error": "Conditional error triggered by header X-Test-Error: down",
  "triggeredBy": "conditional-header-match"
}

TTL (Time to Live)

Les endpoints appartiennent à un code, le sous-domaine de 6 caractères de votre URL. À son expiration, le code est supprimé avec tous ses endpoints. Les nouveaux codes expirent après 1 mois. Une fois un endpoint enregistré, modifiez cette durée avec le bouton horloge à côté de l'URL.

Options disponibles :

1 semaine1 mois (par défaut)3 moisPersonnalisé (1-365 jours)

Idéal pour des tests ou démos temporaires. Pas besoin de nettoyer manuellement.

Request Inspector

Suivez en direct les requêtes reçues par vos endpoints. Activez l'interrupteur « Logging » dans le panneau Request Inspector, sous vos endpoints enregistrés.

  • Les 50 dernières requêtes du code, les plus récentes en premier
  • Méthode, chemin, code de statut et temps de réponse
  • En-têtes, paramètres de requête et corps de la requête (tronqué au-delà de 10KB)
  • En-têtes Authorization et cookie affichés sous la forme [redacted]

La journalisation est désactivée par défaut et couvre tous les endpoints du code. Seules les requêtes correspondant à un endpoint enregistré sont capturées, et elles sont conservées 7 jours après la plus récente. Mettez en pause la vue en direct ou videz la liste à tout moment.

Tâches courantes

Créer un endpoint

  1. Ouvrez mockapi.dog sur l'onglet « API REST (JSON) »
  2. Ajoutez un chemin à l'URL et sélectionnez une méthode HTTP
  3. Saisissez votre réponse JSON
  4. Configurez les paramètres facultatifs
  5. Effectuez la vérification et cliquez sur « Enregistrer l'endpoint simulé »

✓ Votre endpoint est maintenant en ligne !

Modifier un endpoint

  1. Trouvez votre endpoint dans la liste « Endpoints enregistrés »
  2. Cliquez sur le bouton crayon (« Modifier »)
  3. Modifiez la méthode, la réponse, le statut ou les paramètres (l'URL est verrouillée pendant la modification)
  4. Cliquez sur « Mettre à jour l'endpoint »

✓ Les modifications sont en ligne immédiatement

Supprimer un endpoint

  1. Localisez l'endpoint à supprimer
  2. Cliquez sur le bouton corbeille (« Supprimer »)
  3. L'endpoint est supprimé immédiatement, sans demande de confirmation

Cette action est irréversible

Tester un endpoint

Avec curl :

curl https://abc123.mockapi.dog/api/users

Avec JavaScript :

fetch('https://abc123.mockapi.dog/api/users')

Dépannage

L'endpoint renvoie 404 Not Found

Solution: Vérifiez l'URL, la méthode HTTP et le chemin : tous trois doivent correspondre à ce que vous avez enregistré. Si c'est le cas, le code a peut-être expiré et été supprimé avec ses endpoints.

Erreur JSON non valide à la création de l'endpoint

Solution: Validez votre JSON avec l'éditeur intégré. Problèmes courants : virgules manquantes, clés sans guillemets, virgules en trop ou guillemets non échappés.

Erreurs CORS dans le navigateur

Solution: Tous les endpoints incluent automatiquement des en-têtes CORS. Si vous voyez encore des erreurs, vérifiez que vous utilisez la bonne URL et la bonne méthode HTTP.

L'endpoint est trop lent

Solution: Vérifiez si vous avez ajouté un délai de réponse dans les paramètres avancés. Supprimez ou réduisez la valeur du délai si elle n'est pas nécessaire.

Les requêtes renvoient 429 Too Many Requests

Solution: Chaque endpoint a une limite quotidienne d'appels. Une fois atteinte, les appels renvoient 429 avec la limite et une heure resetAt (minuit, heure du serveur) dans le corps. Chaque adresse IP est aussi limitée à 100 requêtes par minute sur l'ensemble du service.

Le Request Inspector n'affiche aucune requête

Solution: La journalisation est désactivée par défaut. Activez l'interrupteur « Logging » dans le Request Inspector, puis appelez de nouveau l'endpoint. Les requêtes vers des chemins sans endpoint enregistré ne sont pas capturées.

Conseils et bonnes pratiques

Utilisez des données réalistes

Incluez des noms de champs, types de données et structures réalistes correspondant à votre vraie API. Cela rend les tests plus utiles.

Testez les cas limites

Créez des endpoints pour des tableaux vides, des valeurs nulles et des scénarios d'erreur. Cela aide à détecter les bugs tôt.

Documentez vos endpoints

Tenez une liste de vos endpoints et de leurs objectifs. Partagez les URL avec votre équipe pour collaborer.

Utilisez les délais à bon escient

Ajoutez de petits délais pour tester les états de chargement. Utilisez des délais plus longs pour vérifier la gestion des timeouts.

Versionnez vos réponses

Créez plusieurs endpoints pour différentes versions d'API. Cela aide à tester la rétrocompatibilité.

Nettoyez les endpoints inutilisés

Supprimez régulièrement les endpoints dont vous n'avez plus besoin. Utilisez le TTL pour faire expirer automatiquement les endpoints temporaires.

Bibliothèque d'API simulées prête à l'emploi

Nous fournissons des API simulées préfabriquées pour les cas d'usage courants. Cliquez sur n'importe quelle catégorie pour explorer des endpoints prêts à l'emploi que vous pouvez tester immédiatement — sans configuration.

API Users

Profils utilisateurs, rôles, permissions et gestion des comptes

API Posts

Articles de blog et publications avec des modèles de gestion de contenu

API Todos

Exemple CRUD classique avec statut, filtrage et pagination

API Auth

Connexion, déconnexion, rafraîchissement de tokens et inscription

API Products

Produits e-commerce avec prix, disponibilité et métadonnées

API Orders

Gestion des commandes avec workflows d'état et association utilisateur

API Cart

Panier d'achat avec gestion des articles et des relations

API Payments

Traitement des paiements avec opérations asynchrones et webhooks

Astuce de pro : explorez la bibliothèque complète

Visitez notre Bibliothèque d'API simulées pour découvrir tous les endpoints préfabriqués avec des exemples en direct, des réponses types et des tests en un clic.

Glossaire

API REST

Representational State Transfer API — un style architectural pour construire des services web à l'aide des méthodes HTTP standard.

Méthodes HTTP

Méthodes de requête standard (GET, POST, PUT, PATCH, DELETE) qui indiquent l'action souhaitée pour une ressource.

Code de statut

Code à trois chiffres renvoyé par le serveur indiquant le résultat d'une requête (200 OK, 404 Not Found, 500 Error, etc.).

JSON

JavaScript Object Notation — un format de données léger pour structurer et échanger des données entre client et serveur.

Endpoint

Une URL spécifique où une API est accessible. Chaque endpoint réalise une fonction précise.

API simulée

Une API simulée qui renvoie des réponses prédéfinies, utilisée pour les tests et le développement sans véritable backend.

CORS

Cross-Origin Resource Sharing — une fonctionnalité de sécurité qui contrôle quels domaines peuvent accéder à votre API depuis les navigateurs.

TTL

Time To Live - la durée pendant laquelle un code et tous ses endpoints existent avant d'être supprimés automatiquement.

Taux d'erreur

Le pourcentage de requêtes qui doivent renvoyer des erreurs. Utilisé pour tester la gestion des erreurs et la logique de réessai.

Délai de réponse

Temps d'attente artificiel ajouté avant l'envoi d'une réponse. Simule des réseaux ou des traitements lents.

Code

Le sous-domaine unique de 6 caractères de votre API simulée (abc123 dans abc123.mockapi.dog). Les endpoints, l'expiration et la journalisation des requêtes sont tous rattachés à un code.

Request Inspector

Un journal en direct des requêtes reçues par les endpoints d'un code, avec les en-têtes, les paramètres de requête et le corps.

Prêt à créer votre première API REST ?

Commencez à construire gratuitement des endpoints d'API REST simulés en quelques secondes. Sans inscription, sans carte bancaire. Idéal pour les tests, le prototypage et le développement.

Créer un endpoint REST →← Retour à la documentation