Guide d'API REST simulée

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

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

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é

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.

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.

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

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.

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.

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

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.

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

Collez ou téléversez un fichier, prévisualisez les endpoints qu'il contient, décochez ceux dont vous ne voulez pas, et importez le reste d'un coup dans le code actuel.

Jusqu'à 100 endpoints et 2 Mo par fichier. Un endpoint dont la méthode et le chemin existent déjà est ignoré, sauf si vous activez « Remplacer les mocks existants ayant la même méthode et le même chemin ».

Dès qu'un code a des endpoints enregistrés, Exporter les télécharge tous dans un fichier qui pointe vers votre URL de mock.

• OpenAPI 3 : chaque endpoint avec son exemple de réponse. Les délais, la simulation d'erreurs et les réglages LLM sont placés dans une extension x-mockapi-dog, donc réimporter le fichier les restaure.
• Collection Postman v2.1 : une requête par endpoint avec sa réponse enregistrée comme exemple, et une variable {{baseUrl}} définie sur votre URL de mock. Les réglages des endpoints ne sont pas inclus.

"/users/1": {
  "get": {
    "responses": { "200": { ... } },
    "x-mockapi-dog": {
      "delayMs": 500,
      "errorRate": 10,
      "errorStatusCode": 503
    }
  }
}

curl -o mocks.json \
  "https://api.mockapi.dog/api/mocks/export?code=abc123&format=openapi"

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. Cliquez sur « Enregistrer l'endpoint simulé » (cochez la case de vérification si elle apparaît)

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 »

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