RestSharp C# (.NET) पूरी गाइड: उदाहरणों के साथ

RestSharp क्या है और इसकी ज़रूरत क्यों है?

RestSharp C# (.NET) के लिए एक लोकप्रिय open-source लाइब्रेरी है, जो RESTful API के साथ काम करना आसान बनाती है। यह HTTP रिक्वेस्ट (GET, POST, PUT, DELETE, PATCH आदि) भेजने और वेब सर्विस से रिस्पॉन्स प्राप्त करने के लिए एक सरल और सहज इंटरफ़ेस प्रदान करती है।

RestSharp कई महत्वपूर्ण समस्याओं को हल करती है:

• कोड को सरल बनाना: HttpClient के लंबे कोड के बजाय, RestSharp एक संक्षिप्त fluent-इंटरफ़ेस देती है।
• ऑटोमैटिक सीरियलाइज़ेशन/डीसीरियलाइज़ेशन: लाइब्रेरी आपके C# ऑब्जेक्ट्स को अपने आप JSON/XML में बदल देती है और वापस, जिससे मैन्युअल काम नहीं करना पड़ता।
• आसान एरर हैंडलिंग: RestSharp HTTP स्टेटस और एक्सेप्शन को संभालने के लिए स्पष्ट क्लासेज़ प्रदान करती है।
• ऑथेंटिकेशन सपोर्ट: OAuth, Basic Auth, JWT और अन्य स्कीम के लिए बिल्ट-इन सपोर्ट।
• फ़ाइलों के साथ काम: फ़ाइलों को आसानी से अपलोड और डाउनलोड करना।

इस लाइब्रेरी का उपयोग .NET एप्लिकेशन (ASP.NET Core, कंसोल एप्लिकेशन, Xamarin, Unity) में बाहरी सर्विसेज़ जैसे सोशल मीडिया, पेमेंट सिस्टम, क्लाउड प्लेटफ़ॉर्म आदि से जुड़ने के लिए किया जाता है।

RestSharp इंस्टॉल कैसे करें

RestSharp NuGet पैकेज मैनेजर के ज़रिए इंस्टॉल होती है। कोई एक तरीका चुनें:

Package Manager Console (Visual Studio) से:

Install-Package RestSharp

.NET CLI (कमांड लाइन) से:

dotnet add package RestSharp

NuGet इंटरफ़ेस (Visual Studio/Rider) से:

Manage NuGet Packages खोलें → RestSharp खोजें → नवीनतम स्थिर वर्शन इंस्टॉल करें।

इंस्टॉल करने के बाद अपने कोड में using डायरेक्टिव जोड़ें:

using RestSharp;

त्वरित शुरुआत: पहला रिक्वेस्ट

चलिए एक सार्वजनिक API (JSONPlaceholder) पर GET रिक्वेस्ट करते हैं और यूज़र्स की लिस्ट प्राप्त करते हैं।

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); // JSON स्ट्रिंग प्रिंट करेगा
}
else
{
    Console.WriteLine($"गलती: {response.StatusCode} - {response.ErrorMessage}");
}

यह कोड एक क्लाइंट बनाता है, /users एंडपॉइंट पर GET रिक्वेस्ट भेजता है और रिस्पॉन्स को कंसोल पर दिखाता है। ध्यान दें: response.IsSuccessful जाँचता है कि स्टेटस कोड 200-299 के बीच है या नहीं।

RestSharp के मुख्य तरीके और फंक्शन

नीचे लाइब्रेरी के प्रमुख तरीके दिए गए हैं, जिनमें विवरण, पैरामीटर और उदाहरण शामिल हैं।

1. RestClient(string baseUrl) — क्लाइंट कंस्ट्रक्टर

विवरण: बेस URL के साथ HTTP क्लाइंट का एक इंस्टेंस बनाता है। सभी बाद के रिक्वेस्ट इसी URL को आधार मानेंगे।

पैरामीटर:

• baseUrl (string) — API का बेस पता (जैसे, "https://api.example.com")।

उदाहरण:

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

2. RestRequest(string resource, Method method) — रिक्वेस्ट बनाना

विवरण: निर्दिष्ट रिसोर्स और HTTP मेथड (GET, POST, PUT, DELETE आदि) के साथ एक रिक्वेस्ट तैयार करता है।

पैरामीटर:

• resource (string) — रिसोर्स का रिलेटिव पथ (जैसे, "/users")।
• method (Method) — Method एनम से HTTP मेथड (Get, Post, Put, Delete, Patch, Head, Options)।

उदाहरण:

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

3. client.Execute(IRe