.net Core Web Api Post Example

5 min read Jun 03, 2024

Créer une API Web .NET Core avec une méthode POST

Introduction

Les API Web sont devenues un élément essentiel du développement d'applications modernes. Elles permettent aux applications de communiquer entre elles via des requêtes HTTP, facilitant ainsi l'échange de données et la création de systèmes distribués. .NET Core, un framework open-source de Microsoft, offre un excellent support pour la création d'API Web robustes et performantes.

Dans cet article, nous allons explorer un exemple simple d'API Web .NET Core avec une méthode POST pour créer un nouveau produit.

Création de l'API Web

Créer un projet .NET Core

Utilisez Visual Studio ou l'interface de ligne de commande pour créer un nouveau projet .NET Core avec le modèle "API Web" :
```
dotnet new webapi -o MyWebApi
cd MyWebApi
```

Créer le modèle de produit

Créez une classe Product dans le dossier Models :

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

Créer le contrôleur

Créez un nouveau contrôleur appelé ProductsController dans le dossier Controllers :

[Route("api/[controller]")]
[ApiController]
public class ProductsController : ControllerBase
{
    // Liste de produits (remplacez par une base de données dans une application réelle)
    private List _products = new List();

    [HttpPost]
    public IActionResult CreateProduct([FromBody] Product product)
    {
        if (product == null)
        {
            return BadRequest();
        }

        // Génération d'un ID (remplacez par une stratégie d'ID appropriée)
        product.Id = _products.Count + 1;

        _products.Add(product);

        return CreatedAtAction(nameof(GetProduct), new { id = product.Id }, product);
    }

    // ... autres méthodes (GET, PUT, DELETE)
}

La route [Route("api/[controller]")] définit la racine de l'API.
L'attribut [HttpPost] indique que la méthode gère les requêtes POST.
L'attribut [FromBody] indique que les données du corps de la requête seront liées à l'objet Product.
La méthode CreatedAtAction renvoie un code d'état 201 Created et inclut l'URI du nouveau produit dans l'en-tête Location.

Test de l'API

Exécuter l'application

Exécutez l'application .NET Core à l'aide de la commande dotnet run.
Envoyer une requête POST

Utilisez un outil comme Postman ou curl pour envoyer une requête POST à l'URL http://localhost:5000/api/products.

Body (JSON):
```
{
    "Name": "Produit 1",
    "Price": 10.99
}
```
Vérifier la réponse

Vous devriez recevoir une réponse 201 Created avec l'URI du nouveau produit dans l'en-tête Location.

Conclusion

Cet exemple simple illustre la création d'une API Web .NET Core avec une méthode POST. Vous pouvez étendre cette API en ajoutant d'autres méthodes (GET, PUT, DELETE) pour implémenter un ensemble complet d'opérations CRUD.

Points clés:

Les API Web facilitent la communication entre applications.
.NET Core offre un framework puissant pour créer des API Web.
Les méthodes POST sont utilisées pour créer de nouveaux produits.
Il est important de valider les données d'entrée pour éviter les erreurs.

N'hésitez pas à modifier et à adapter cet exemple à vos besoins spécifiques. Vous pouvez trouver des informations plus détaillées sur le développement d'API Web .NET Core dans la documentation officielle :