.net Core Web Api Post Method Example

6 min read Jun 03, 2024

Créer un point de terminaison POST avec ASP.NET Core Web API

Introduction

ASP.NET Core Web API est un framework puissant pour la création d'API RESTful. Il permet de créer des services web qui peuvent être utilisés par différentes applications, comme des applications mobiles, des applications web ou même d'autres API. Dans cet article, nous allons explorer comment créer un point de terminaison POST simple avec ASP.NET Core Web API.

Créer un projet ASP.NET Core Web API

Commencez par créer un nouveau projet ASP.NET Core Web API dans Visual Studio.

Ouvrez Visual Studio et sélectionnez "Créer un projet".
Dans la boîte de dialogue "Créer un projet", sélectionnez "ASP.NET Core Web Application" et cliquez sur "Suivant".
Nommez votre projet et choisissez le framework ".NET 6".
Dans la page suivante, sélectionnez "API Web" et assurez-vous que "Configurer pour HTTPS" est coché.
Cliquez sur "Créer".

Créer un contrôleur

Dans votre projet, créez un nouveau contrôleur en cliquant avec le bouton droit sur le dossier "Controllers" et en sélectionnant "Ajouter" -> "Contrôleur". Sélectionnez "Contrôleur API Web" et nommez-le "ProduitsController".

Définir le modèle

Créez un modèle de données "Produit" pour représenter les données que vous allez manipuler. Vous pouvez le faire dans un nouveau fichier de classe appelé "Produit.cs" dans le dossier "Models".

namespace MonAPI.Models
{
    public class Produit
    {
        public int Id { get; set; }
        public string Nom { get; set; }
        public string Description { get; set; }
        public decimal Prix { get; set; }
    }
}

Créer le point de terminaison POST

Dans le contrôleur "ProduitsController", ajoutez la méthode POST suivante:

[HttpPost]
public IActionResult CreerProduit([FromBody] Produit produit)
{
    // Logique pour créer le produit (enregistrer en base de données, etc.)
    // ...

    // Retourner une réponse HTTP 201 (Created)
    return CreatedAtAction("GetProduit", new { id = produit.Id }, produit);
}

Explication:

[HttpPost]: Cet attribut indique que cette méthode gère les requêtes HTTP POST.
[FromBody]: Cet attribut indique que les données du corps de la requête doivent être désérialisées dans l'objet produit.
IActionResult: Le type de retour est IActionResult, ce qui permet de retourner différents types de réponses HTTP.
CreatedAtAction: Cette méthode est utilisée pour retourner une réponse HTTP 201 (Created) et inclut l'URL de la ressource nouvellement créée.

Tester le point de terminaison

Vous pouvez tester votre point de terminaison POST en utilisant un outil comme Postman ou curl.

Postman:
- Créez une nouvelle requête POST.
- Configurez l'URL du point de terminaison (par exemple: https://localhost:5001/api/Produits).
- Dans l'onglet "Body", sélectionnez "Raw" et choisissez "JSON" comme type de contenu.
- Collez le JSON suivant dans le corps de la requête:
```
{
    "Nom": "Produit 1",
    "Description": "Description du produit 1",
    "Prix": 10.99
}
```
- Envoyez la requête. Vous devriez obtenir une réponse 201 (Created) avec l'URL de la ressource nouvellement créée.

curl:

Ouvrez votre terminal et exécutez la commande suivante:

curl -X POST -H "Content-Type: application/json" -d '{"Nom": "Produit 2", "Description": "Description du produit 2", "Prix": 19.99}' https://localhost:5001/api/Produits

Conclusion

Vous avez maintenant créé un point de terminaison POST simple avec ASP.NET Core Web API. Vous pouvez utiliser cette méthode pour recevoir des données du client et les traiter dans votre application. N'oubliez pas d'ajouter la logique nécessaire pour gérer les données reçues, comme les enregistrer dans une base de données ou les traiter de manière appropriée.