30 मिनट में C# पर REST API कैसे लिखें: चरण-दर-चरण मार्गदर्शिका

शुरुआती लोगों के लिए ऑनलाइन Python प्रशिक्षक

Python आसानी से सीखें बिना सिद्धांत के बोझ के। स्वचालित जांच के साथ व्यावहारिक कार्य हल करें और ब्राउज़र में सीधे कोड लिखें।

पाठ्यक्रम शुरू करें

परिचय: C# पर REST API — तेज़ और सरल

आधुनिक वेब एप्लिकेशन और मोबाइल सेवाओं का विकास REST API के बिना संभव नहीं है। यदि आप अपने प्रोजेक्ट के लिए जल्दी से बैकएंड बनाना चाहते हैं, तो ASP.NET Core फ्रेमवर्क के साथ C# एक आदर्श विकल्प है। अंतर्निहित टूल, न्यूनतम कॉन्फ़िगरेशन और उत्कृष्ट प्रदर्शन के कारण, आप सचमुच 30 मिनट में एक पूर्ण REST API लिख सकते हैं।

इस लेख में, हम कार्य सूची (Todo List) के प्रबंधन के लिए एक सरल API बनाने की प्रक्रिया पर चर्चा करेंगे। आप सीखेंगे कि प्रोजेक्ट कैसे सेट करें, डेटा मॉडल कैसे बनाएं, CRUD संचालन के साथ कंट्रोलर कैसे लागू करें और Swagger का उपयोग करके API का परीक्षण कैसे करें। सभी कोड उदाहरण C# (.NET 8) में लिखे गए हैं।

भले ही आप C# में नए हों, निर्देशों का पालन करके, आपको लेख के अंत तक एक कार्यशील API मिल जाएगा।

1. प्रोजेक्ट बनाना और वातावरण सेट करना

सबसे पहले सुनिश्चित करें कि आपके पास .NET SDK (संस्करण 8 या उच्चतर) स्थापित है। इसे आधिकारिक वेबसाइट से डाउनलोड किया जा सकता है। स्थापना के बाद, टर्मिनल या कमांड प्रॉम्प्ट खोलें।

ASP.NET Core Web API का एक नया प्रोजेक्ट इस कमांड से बनाएं:

dotnet new webapi -n TodoApicd TodoApi

यह कमांड बुनियादी प्रोजेक्ट संरचना के साथ TodoApi फ़ोल्डर बनाएगा। इसमें पहले से ही Program.cs फ़ाइल — प्रवेश बिंदु, और भविष्य के कंट्रोलर के लिए Controllers फ़ोल्डर है।

प्रोजेक्ट को Visual Studio, Visual Studio Code या Rider में खोलें। सरलता के लिए, आप किसी भी टेक्स्ट एडिटर का उपयोग कर सकते हैं।

सुनिश्चित करें कि Program.cs फ़ाइल में AddSwaggerGen() और UseSwagger() का कॉल मौजूद है। Swagger टेम्पलेट में स्वचालित रूप से शामिल है — इससे परीक्षण सरल हो जाएगा। यदि यह नहीं है, तो जोड़ें:

builder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen();// ...app.UseSwagger();app.UseSwaggerUI();

2. डेटा मॉडल और अस्थायी भंडारण बनाना

हमारे API के लिए, हम कार्यों को रैम (in-memory) में संग्रहीत करेंगे। वास्तविक प्रोजेक्ट में, आप एक डेटाबेस कनेक्ट करेंगे, लेकिन 30 मिनट के समाधान के प्रदर्शन के लिए यह पर्याप्त है।

Models फ़ोल्डर बनाएं और उसके अंदर TodoItem.cs फ़ाइल बनाएं:

public class TodoItem{    public int Id { get; set; }    public string Title { get; set; } = string.Empty;    public bool IsCompleted { get; set; }}

अब एक सरल सेवा-रिपॉजिटरी बनाते हैं। Services फ़ोल्डर में, इंटरफ़ेस ITodoService.cs और इसका कार्यान्वयन TodoService.cs बनाएं। इससे भविष्य में वास्तविक डेटाबेस पर स्विच करना आसान हो जाएगा।

ITodoService.cs:

public interface ITodoService{    List<TodoItem> GetAll();    TodoItem? GetById(int id);    TodoItem Create(TodoItem item);    TodoItem? Update(int id, TodoItem item);    bool Delete(int id);}

TodoService.cs:

public class TodoService : ITodoService{    private readonly List<TodoItem> _items = new();    private int _nextId = 1;

    public List<TodoItem> GetAll() => _items;

    public TodoItem? GetById(int id) => _items.FirstOrDefault(i => i.Id == id);

    public TodoItem Create(TodoItem item)    {        item.Id = _nextId++;        _items.Add(item);        return item;    }

    public TodoItem? Update(int id, TodoItem item)    {        var existing = GetById(id);        if (existing == null) return null;        existing.Title = item.Title;        existing.IsCompleted = item.IsCompleted;        return existing;    }

    public bool Delete(int id)    {        var item = GetById(id);        if (item == null) return false;        return _items.Remove(item);    }}

Program.cs में DI कंटेनर में सेवा पंजीकृत करें: