RestSharp C# (.NET) : guide complet avec exemples

Qu'est-ce que RestSharp et pourquoi l'utiliser ?

RestSharp est une bibliothèque open-source populaire pour le langage C# (.NET), conçue pour simplifier l'interaction avec les API RESTful. Elle offre une interface intuitive et fluide pour effectuer des requêtes HTTP (GET, POST, PUT, DELETE, PATCH, etc.) et traiter les réponses des services web.

RestSharp résout plusieurs problèmes clés :

• Code simplifié : Au lieu d'écrire un code verbeux avec HttpClient, RestSharp propose une interface fluide et concise.
• Sérialisation/désérialisation automatique : La bibliothèque convertit automatiquement vos objets C# en JSON/XML et vice versa, éliminant le travail manuel.
• Gestion des erreurs simplifiée : RestSharp fournit des classes claires pour gérer les statuts HTTP et les exceptions.
• Support de l'authentification : Prise en charge intégrée de OAuth, Basic Auth, JWT et d'autres schémas.
• Gestion des fichiers : Téléchargement et envoi de fichiers en toute simplicité.

La bibliothèque est largement utilisée dans les applications .NET (ASP.NET Core, applications console, Xamarin, Unity) pour l'intégration avec des services externes : réseaux sociaux, systèmes de paiement, plateformes cloud, etc.

Installation de RestSharp

RestSharp s'installe via le gestionnaire de paquets NuGet. Choisissez l'une des méthodes suivantes :

Via la console du gestionnaire de paquets (Visual Studio) :

Install-Package RestSharp

Via l'interface en ligne de commande .NET :

dotnet add package RestSharp

Via l'interface NuGet (Visual Studio/Rider) :

Ouvrez Manage NuGet Packages → recherchez RestSharp → installez la dernière version stable.

Après l'installation, ajoutez la directive using dans votre code :

using RestSharp;

Premiers pas : votre première requête

Effectuons une simple requête GET vers une API publique (JSONPlaceholder) pour récupérer la liste des utilisateurs.

using RestSharp;

var client = new RestClient("https://jsonplaceholder.typicode.com");
var request = new RestRequest("/users", Method.Get);

var response = client.Execute(request);

if (response.IsSuccessful)
{
    Console.WriteLine(response.Content); // Affiche la chaîne JSON
}
else
{
    Console.WriteLine($"Erreur : {response.StatusCode} - {response.ErrorMessage}");
}

Ce code crée un client, construit une requête GET vers l'endpoint /users et affiche la réponse dans la console. Notez que response.IsSuccessful vérifie que le statut de la réponse est compris entre 200 et 299.

Méthodes et fonctions essentielles de RestSharp

Voici les méthodes clés de la bibliothèque avec leur description, leurs paramètres et des exemples.

1. RestClient(string baseUrl) — Constructeur du client

Description : Crée une instance du client HTTP avec une URL de base. Toutes les requêtes suivantes utiliseront cette URL comme base.

Paramètres :

• baseUrl (string) — l'adresse de base de l'API (par exemple, "https://api.example.com").

Exemple :

var client = new RestClient("https://api.github.com");

2. RestRequest(string resource, Method method) — Création d'une requête

Description : Construit une requête HTTP vers une ressource spécifique avec la méthode HTTP choisie (GET, POST, PUT, DELETE, etc.).

Paramètres :

• resource (string) — le chemin relatif vers la ressource (par exemple, "/users").
• method (Method) — la méthode HTTP issue de l'énumération Method (Get, Post, Put, Delete, Patch, Head, Options).

Exemple :

var request = new RestRequest("/users/1", Method.Get);

3. client.Execute(IRe