Lecture 17: Méthode DELETE

Développement d’API REST : Construire, Tester, Dépanner

La méthode DELETE dans les API REST est utilisée pour supprimer une ressource existante du serveur. Elle permet aux clients de demander qu’un enregistrement spécifique soit supprimé du système.

Cette méthode est une partie essentielle des opérations CRUD (Créer, Lire, Mettre à jour, Supprimer) et est généralement utilisée lorsque les données ne doivent plus exister dans la base de données.

Objectif de la méthode DELETE

La méthode DELETE permet au client de supprimer une ressource identifiée par un identifiant unique. Cette opération aide à maintenir des données propres et précises dans le système.

Exemples courants :

Exemple de requête DELETE

Les requêtes DELETE sont généralement envoyées à un point d’accès spécifique qui inclut l’identifiant de la ressource à supprimer.

DELETE /api/products/5

Cette requête demande au serveur de supprimer le produit avec l’ID 5.

Traitement côté serveur

Lorsque l’API reçoit une requête DELETE, le serveur effectue généralement les étapes suivantes :

Exemple de réponse

Dans de nombreux cas, les opérations DELETE renvoient une réponse de confirmation au lieu de l’objet supprimé.

{ "message": "Produit supprimé avec succès" }

Codes de statut HTTP pour DELETE

Tester les requêtes DELETE

Les développeurs testent souvent les requêtes DELETE en utilisant des outils comme Postman. Ces outils permettent d’envoyer des requêtes HTTP à l’API et de vérifier que la ressource a bien été supprimée.

Exemple d’endpoint testé dans Postman :

https://localhost:5001/api/products/5

Bonnes pratiques

Les suppressions logiques sont une pratique courante où les enregistrements sont marqués comme supprimés au lieu d’être définitivement retirés. Cette approche permet de conserver les données historiques et facilite la récupération si nécessaire.

Conclusion

La méthode DELETE complète le cycle CRUD dans le développement d’API REST. Avec GET, POST et PUT, elle permet aux développeurs de créer des API entièrement fonctionnelles capables de gérer les données efficacement.