Créer une API REST avec .NET Core : Un exemple simple
Introduction
.NET Core est un framework open-source et multiplateforme utilisé pour développer des applications web, des services web et des applications mobiles. Il est particulièrement populaire pour la création d'API REST, qui sont des interfaces qui permettent aux applications de communiquer entre elles via des requêtes HTTP.
Dans cet article, nous allons créer un exemple simple d'API REST avec .NET Core pour illustrer les concepts de base de ce type d'architecture.
Installation et configuration
Avant de commencer, assurez-vous d'avoir installé .NET Core sur votre machine. Vous pouvez le télécharger depuis le site officiel de Microsoft. Ensuite, créez un nouveau projet .NET Core en utilisant l'interface de ligne de commande (CLI) :
dotnet new webapi -n MyWebApi
Ceci créera un nouveau projet nommé MyWebApi avec une structure de base pour une API REST.
Création d'un contrôleur
Un contrôleur est une classe qui gère les requêtes HTTP et renvoie des réponses. Dans notre exemple, nous allons créer un contrôleur simple qui retournera une liste de produits.
// Controllers/ProductsController.cs
using Microsoft.AspNetCore.Mvc;
namespace MyWebApi.Controllers
{
[ApiController]
[Route("[controller]")]
public class ProductsController : ControllerBase
{
private readonly List _products = new List()
{
new Product { Id = 1, Name = "Produit 1", Price = 10 },
new Product { Id = 2, Name = "Produit 2", Price = 20 },
new Product { Id = 3, Name = "Produit 3", Price = 30 }
};
[HttpGet]
public IEnumerable Get()
{
return _products;
}
}
public class Product
{
public int Id { get; set; }
public string Name { get; set; }
public decimal Price { get; set; }
}
}
Ce code crée un contrôleur nommé ProductsController avec une action Get qui renvoie une liste de Products. La classe Product représente un produit avec un ID, un nom et un prix.
Lancement de l'API
Une fois le contrôleur créé, vous pouvez lancer l'API en utilisant la commande suivante :
dotnet run
L'API sera accessible à l'adresse http://localhost:5000/. Vous pouvez tester l'action Get en utilisant un outil de test HTTP comme Postman ou curl. Par exemple, la commande curl suivante affichera la liste des produits :
curl http://localhost:5000/products
Conclusion
Cet exemple simple illustre les concepts de base de la création d'une API REST avec .NET Core. Vous pouvez étendre ce code en ajoutant d'autres contrôleurs, actions et fonctionnalités.
Points importants à retenir
- .NET Core est un framework puissant pour la création d'API REST.
- Les contrôleurs gèrent les requêtes HTTP et renvoient des réponses.
- Les actions dans les contrôleurs définissent les points d'entrée de l'API.
- Vous pouvez tester votre API en utilisant des outils de test HTTP.
En utilisant .NET Core, vous pouvez créer des API REST robustes et évolutives qui peuvent être utilisées pour développer des applications web modernes.