ASP .Net

Prérequis

• Faire confiance au certificat SSL local (pour le dev) dotnet dev-certs https --trust

Création d'une API minimals (un seul fichier)

• Créer un Projet d'API "minimal API" dotnet new webapi -o HelloApi. Ensuite, cd HelloApi.
• Les éléments suivants sont créés (on peut voir avec un ls):
  • Program.cs: point d'entrée de l'application qui définit déjà un API Rest et un endoint get.
  • api01.csproj: fichier de configuration du projet.
  • api01.http: fichier de test de l'API avec l'extension VSCode Rest Client.
  • Properties, appsettings.Development.json et appsettings.json: permettent de configurer l'application et le serveur
• Lancer le serveur dotnet run, ou en mode hot reload dotnet watch run
• Tester l'API avec un client REST (comme Rest Client de VSCode)

calls.http

@base_url = http://localhost:5122

GET {{base_url}}/weatherforecast/
Accept: application/json

Autre exemple

calls.http

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

List<Hero> heroes = [
  new() { Id = 1, Name = "garan", Role = Role.Fighter },
  new() { Id = 2, Name = "saraka", Role = Role.Spport },
];

app.MapGet("/heroes", () => heroes);
// Path parameter
app.MapGet("/heroes/{id}", (int id) => heroes[id]);
app.MapGet("/", () => "Hello World!");

app.Run();

public enum Role
{
  Fighter, Mage, Spport, Shooter
}
public class Hero
{
  public int Id { get; set; }
  public required string Name { get; set; }
  public required Role Role { get; set; }
}

Ressources

• Tutoriel officiel