# 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](/content/fr/index.html) et sélectionnez l'onglet « API REST ».

2. 2

#### Choisissez la méthode HTTP

Sélectionnez GET, POST, PUT, PATCH ou DELETE selon vos besoins.

3. 3

#### Rédigez votre réponse JSON

Saisissez les données JSON que l'endpoint doit renvoyer. L'éditeur valide le JSON en temps réel.

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

4. 4

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

Ajoutez des délais, codes de statut, taux d'erreur ou en-têtes personnalisés si nécessaire.

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.

- 200 OK - Succès
- 201 Créé
- 400 Requête incorrecte
- 401 Non autorisé
- 500 Erreur 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

Simulez des réseaux lents ou des temps de traitement serveur en ajoutant des délais aux réponses.

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 - Rapide
2000 ms - Normal
5000 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'erreurs
50 % d'erreurs
100 % d'erreurs

### Erreurs conditionnelles

Renvoyez des erreurs en fonction de conditions spécifiques telles que les valeurs d'en-tête ou les motifs de requête.

Exemples de cas d'usage :

- En-tête manquant : Renvoie 401 si l'en-tête X-API-Key est absent
- ID spécifique : Renvoie 404 pour userId « 999 » afin de tester les scénarios non trouvés
- Méthode de requête : Renvoie 405 pour les méthodes HTTP non prises en charge

### TTL (Time to Live)

Définissez une durée d'expiration pour vos endpoints. Ils sont automatiquement supprimés après la durée spécifiée.

Options disponibles :

1 heure
24 heures
7 jours
30 jours

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

## Tâches courantes

### Créer un endpoint

1. Cliquez sur le bouton « Créer un endpoint REST »
2. Sélectionnez la méthode HTTP
3. Saisissez votre réponse JSON
4. Configurez les paramètres facultatifs
5. Cliquez sur « Créer l'endpoint »

✓ Votre endpoint est maintenant en ligne !

### Modifier un endpoint

1. Trouvez votre endpoint dans la liste « Mes endpoints »
2. Cliquez sur le bouton « Modifier »
3. Modifiez la réponse, le statut ou les paramètres
4. Enregistrez les modifications

✓ Les modifications sont en ligne immédiatement

### Supprimer un endpoint

1. Localisez l'endpoint à supprimer
2. Cliquez sur le bouton « Supprimer »
3. Confirmez la suppression

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 de l'endpoint. Assurez-vous d'utiliser l'URL exacte fournie après création, y compris l'identifiant unique.

#### 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.

## 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.

## 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 endpoint existe avant suppression automatique. Utile pour les tests temporaires.

#### 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.