Journal de Bord #72 – J’ai découvert .NET

J’ai découvert .NET

Bonjour mon journal,

Il y a quelques semaines, je vous parlais de mon expérience avec Python et les API. Aujourd’hui le sujet est un peu différent car je souhaiterais vous raconter la création de ma première API sur .NET.

La petite histoire

Il y a plusieurs années à Cuba (d’où je viens), j’ai entendu parler de .NET et à l’époque, je ne me sentais pas vraiment concerné mais aujourd’hui, j’ai voulu aller plus loin. Je me suis demandé « Comment faire une API? »

En bon élève que je suis quand le sujet attire mon attention, j’ai commencé mes recherches : lecture de documentation, visionnage de vidéos, écoute de conférences (NDC). Avec beaucoup d’informations et mon expérience avec C# (sur Unity 3D), la solution parfaite pour moi était les API minimales sur .NET. La transition a été assez naturelle et j’ai compris beaucoup de choses sur le développement d’une API :

• C’est finalement plus “simple” que je ne pensais, de créer une API basique.
• Les routes API sont virtuelles, elles ne sont pas liées au système de fichiers du système d’exploitation.
• Sûr .NET la génération du document OpenAPI (Swagger) se fait automatiquement avec le Nuget Package : Swashbuckle.

Partage de connaissances acquises

Répondons (avec un POC) à la question: Comment faire une API?

1. Installation de .Net SDK 6.0 (ou plus)
2. Installation de VS Code
3. Sur le “Terminal” de VS Code créer un nouveau projet dotnet: (dotnet new web -n “api”)
4. Ajouter les lignes de code suivants dans le fichier “Program.cs”

   var builder = WebApplication.CreateBuilder();
   
   var app = builder.Build();
   
   app.MapGet("/", () => { return Results.Ok(); });
   
   app.Run();

5. Voilà notre API!!!.

C’est si facile de faire un POC comme celui-là et un peu plus car pour l’instant j’ai des endpoints avec les méthodes CRUD basiques. En revanche il me manque encore:

• L’ajout d’une base de données.
• La validation des données entrées par les utilisateurs.
• Implémenter autorisation OAuth2.
• Et évidemment le code fonctionnel qui donne une utilité à l’API.

Conclusion

Je suis très fier d’avoir réussi à créer ma première API! Mais ce n’est pas fini car je vais encore gravir cette échelle qui représente notre spectre de compétences. Encore une fois mon cher journal, j’ai la preuve qu’avec une belle dose de motivation, tout le monde peut faire des choses incroyables.

 

Prends soin de toi et n’oubliez pas de toujours aller plus loin!

José Mario

 

Si vous souhaitez découvrir ou relire des numéros du Journal de bord, cliquez ici

On vous invite aussi à nous suivre sur Linkedin et Twitter !