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

परिचय: C# में REST API — यह आसान है

REST API (Representational State Transfer) एक आर्किटेक्चरल शैली है जो क्लाइंट और सर्वर को HTTP के माध्यम से डेटा का आदान-प्रदान करने की अनुमति देती है। आधुनिक वेब डेवलपमेंट में, API मोबाइल ऐप्स, वेबसाइटों और माइक्रोसर्विसेज के बैकएंड बनाने के लिए डी-फैक्टो मानक है। .NET (C#) प्लेटफॉर्म पर, REST API डेवलपमेंट अत्यधिक अनुकूलित है: आप आधे घंटे में एक कार्यशील प्रोटोटाइप प्राप्त कर सकते हैं, भले ही आप शुरुआती हों।

इस लेख में, हम कार्यों की सूची (ToDo List) प्रबंधित करने के लिए एक पूर्ण REST API बनाएंगे। आप सीखेंगे कि ASP.NET Core Web API प्रोजेक्ट कैसे सेट करें, डेटा मॉडल कैसे बनाएं, CRUD-ऑपरेशन (Create, Read, Update, Delete) कैसे लागू करें और Swagger के माध्यम से API का परीक्षण कैसे करें। पूरी प्रक्रिया में 30 मिनट से अधिक नहीं लगेगा।

1. प्रोजेक्ट बनाना और डिपेंडेंसी स्थापित करना

सबसे पहले Visual Studio 2022 (या Visual Studio Code जिसमें .NET SDK 6.0/7.0/8.0 स्थापित हो) खोलें। निम्नलिखित चरणों का पालन करें:

1. नया प्रोजेक्ट बनाएं → ASP.NET Core Web API चुनें।
2. प्रोजेक्ट को नाम दें, उदाहरण के लिए TodoApi।
3. सुनिश्चित करें कि फ्रेमवर्क .NET 8.0 (या उच्चतर) चुना गया है।
4. यदि आप मिनिमल API का उपयोग करना चाहते हैं तो Use controllers का चेकबॉक्स हटा दें, लेकिन इस गाइड में हम क्लासिक कंट्रोलर का उपयोग करेंगे — चेकबॉक्स को चेक रखें।
5. बनाएं पर क्लिक करें।

प्रोजेक्ट बनने के बाद संरचना इस प्रकार दिखेगी:

TodoApi/├── Controllers/├── Models/├── Program.cs└── appsettings.json

अतिरिक्त पैकेज स्थापित करने की आवश्यकता नहीं है — सभी आवश्यक घटक पहले से ही ASP.NET Core में निर्मित हैं।

2. डेटा मॉडल और डेटाबेस कॉन्टेक्स्ट बनाना

2.1. TodoItem मॉडल

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

namespace TodoApi.Models;

public class TodoItem{    public int Id { get; set; }    public string? Title { get; set; }    public bool IsComplete { get; set; }}

यह न्यूनतम मॉडल है: आइडेंटिफ़ायर, कार्य का शीर्षक और पूर्णता फ़्लैग।

2.2. डेटाबेस कॉन्टेक्स्ट

अब Entity Framework Core के लिए कॉन्टेक्स्ट बनाएं। Data फ़ोल्डर (इसे बनाएं) में TodoContext.cs क्लास जोड़ें:

using Microsoft.EntityFrameworkCore;using TodoApi.Models;

namespace TodoApi.Data;

public class TodoContext : DbContext{    public TodoContext(DbContextOptions<TodoContext> options)        : base(options)    {    }

    public DbSet<TodoItem> TodoItems { get; set; }}

2.3. Program.cs कॉन्फ़िगरेशन

Program.cs खोलें और कॉन्टेक्स्ट और Swagger का रजिस्ट्रेशन जोड़ें:

using Microsoft.EntityFrameworkCore;using TodoApi.Data;

var builder = WebApplication.CreateBuilder(args);

// कंट्रोलर जोड़ेंbuilder.Services.AddControllers();

// DB कॉन्टेक्स्ट रजिस्टर करें (सरलता के लिए InMemory का उपयोग करें)builder.Services.AddDbContext<TodoContext>(opt =>    opt.UseInMemoryDatabase("TodoList"));

// Swaggerbuilder.Services.AddEndpointsApiExplorer();builder.Services.AddSwaggerGen();

var app = builder.Build();

if (app.Environment.IsDevelopment()){    app.UseSwagger();    app.UseSwaggerUI();}

app.UseHttpsRedirection();app.UseAuthorization();app.MapControllers();

app.Run();

ध्यान दें: हम UseInMemoryDatabase का उपयोग कर रहे हैं — यह प्रोटोटाइपिंग के लिए सुविधाजनक है। वास्तविक प्रोजेक्ट में इसे SQL Server, PostgreSQL या किसी अन्य DB से बदलें।

3. CRUD-ऑपरेशन के साथ कंट्रोलर लागू करना

अब सबसे महत्वपूर्ण भाग — कंट्रोलर। Controllers फ़ोल्डर में TodoItemsController.cs फ़ाइल बनाएं:

using Microsoft.AspNetCore.Mvc;\