Quartz 5

8. Postman

6 min read

হ্যালো হাসিব! তোমার দেওয়া লেকচার ট্রান্সক্রিপ্টটি আমি খুব গভীরভাবে অ্যানালাইজ করেছি। এই লেকচারে মূলত এপিআই (API) এবং ওয়েব ডেভেলপমেন্টের জন্য সবচেয়ে জনপ্রিয় টেস্টিং টুল— Postman-এর পরিচিতি, এর প্রয়োজনীয়তা এবং কীভাবে ASP.NET Core প্রজেক্টের সাথে কাস্টম Request Headers টেস্ট করতে হয়, তা দেখানো হয়েছে।

ভবিষ্যতে দ্রুত রিভিশন দেওয়ার জন্য নিচে প্রথমে একটি কুইক সামারি এবং এরপর বিস্তারিত ব্রেকডাউন দেওয়া হলো।

📝 Quick Summary for Revision

  • Postman Overview: এটি একটি থার্ড-পার্টি টেস্টিং টুল, যা ডেভেলপারদের ব্রাউজারের চেয়ে অনেক বেশি কন্ট্রোল দিয়ে API, HTTP Requests এবং Response টেস্ট করতে সাহায্য করে।
  • Key Capability: Postman দিয়ে Response Body, Headers, Status Code এবং বিভিন্ন Content-Type (যেমন: Form Data, JSON, XML) খুব সহজেই ইনভেস্টিগেট ও সেন্ড করা যায়।
  • The Big Advantage over Browsers: ব্রাউজার থেকে আমরা ম্যানুয়ালি কাস্টম Request Headers (যেমন: Authorization) বা POST/PUT রিকোয়েস্ট সহজে পাঠাতে পারি না। Postman-এ এটি মাত্র কয়েক ক্লিকের ব্যাপার।
  • Port Mapping: প্রজেক্ট রান করার পর launchSettings.json-এ থাকা পোর্টের সাথে মিল রেখে Postman-এ URL (e.g., http://localhost:6734) বসাতে হয়।
  • Reading Custom Headers: context.Request.Headers.ContainsKey("Authorization") দিয়ে রিকোয়েস্ট হেডার চেক করে ব্যাকএন্ড কোডে ডেটা রিড করা যায়।

🧠 Comprehensive Breakdown

এখানে লেকচারের প্রতিটি কনসেপ্ট বিস্তারিতভাবে ব্যাখ্যা করা হলো এবং এর পেছনের লজিক বা “Why” (কেন এবং কীভাবে কাজ করে) যুক্তিগুলো তুলে ধরা হলো।

1. What is Postman & Why Do We Need It? [Priority: 10/10]

What and Why: সাধারণ ব্রাউজারগুলো (যেমন Chrome, Firefox) মূলত তৈরি হয়েছে ওয়েবপেজ দেখার জন্য (GET Request)। কিন্তু একজন ব্যাকএন্ড বা API ডেভেলপার হিসেবে তোমাকে শুধু ডেটা দেখলেই চলে না; তোমাকে সার্ভারে ডেটা পাঠাতে হয় (POST), আপডেট করতে হয় (PUT), এবং ডিলিট করতে হয় (DELETE)। তাছাড়া, রিকোয়েস্টের সাথে সিকিউরিটি টোকেন বা কাস্টম হেডার পাঠাতে হয়। ব্রাউজার দিয়ে এই কাজগুলো ম্যানুয়ালি করা অসম্ভব।

Postman হলো এমন একটি ডেডিকেটেড ডেস্কটপ অ্যাপ্লিকেশন যা ব্রাউজারের এই সীমাবদ্ধতা দূর করে। এটি ডেভেলপারকে পুরো HTTP Request এবং Response পাইপলাইনের ওপর ১০০% কন্ট্রোল দেয়। Postman দিয়ে তুমি:

  • যেকোনো HTTP Method (GET, POST, PUT, DELETE) কল করতে পারো।
  • Response-এর Status Code, Raw Headers এবং সুন্দরভাবে ফরম্যাট করা Body দেখতে পারো।
  • Request-এর বডিতে JSON, XML বা Form-data পাঠাতে পারো।

2. Installing and Setting up Postman [Priority: 4/10]

লেকচারার পোস্টম্যানের ডেস্কটপ অ্যাপ ইনস্টল করার গাইডলাইন দিয়েছেন:

  1. postman.com থেকে নিজ অপারেটিং সিস্টেম অনুযায়ী অ্যাপটি ডাউনলোড করতে হবে।
  2. ইনস্টল করার পর ইন্টারফেসের ফন্ট সাইজ বড় বা জুম (Zoom) করার জন্য কীবোর্ড শর্টকাট হলো Ctrl + + (এবং ছোট করার জন্য Ctrl + -)।
  3. পোস্টম্যানে সাইন-ইন (Sign-in) করাটা সম্পূর্ণ ঐচ্ছিক (Optional), সাইন-ইন না করেও কাজ করা যায়। (নোট: লেকচারে পুরোনো ভার্সন ৯.১৩ এর কথা বলা হলেও, ইন্টারফেসের মূল লজিক বর্তমানের লেটেস্ট ভার্সনগুলোতেও একই রকম)।

3. Making Your First Request and Port Identification [Priority: 9/10]

Postman ওপেন করে একটি নতুন ট্যাব (+ আইকন) ক্রিয়েট করতে হবে। সেখানে রিকোয়েস্ট পাঠানোর জন্য URL বক্স পাওয়া যাবে।

The Concept of Ports: প্রজেক্টটি রান করলে Kestrel সার্ভার একটি নির্দিষ্ট পোর্টে (যেমন: 6734 বা 5166) ওপেন হয়। এই পোর্ট নাম্বারটি অ্যাপ্লিকেশন ভেদে আলাদা হতে পারে, যা প্রজেক্টের Properties/launchSettings.json ফাইলে ডিফাইন করা থাকে। ব্রাউজারের URL বার থেকে পোর্টটি দেখে নিয়ে হুবহু সেটি পোস্টম্যানে বসাতে হবে (যেমন: http://localhost:6734/) এবং Send বাটনে ক্লিক করতে হবে। Kestrel সার্ভার রিকোয়েস্টটি প্রসেস করে রেসপন্স পোস্টম্যানে ফেরত পাঠাবে।

4. The Power of Custom Request Headers & Code Implementation [Priority: 10/10]

ব্রাউজার অটোমেটিকভাবে কিছু হেডার পাঠায় (যেমন User-Agent, Host)। কিন্তু তুমি যদি কোনো সিকিউরড এপিআই তৈরি করো, যেখানে ইউজারকে একটি কাস্টম টোকেন বা এপিআই কী (API Key) পাঠাতে হবে, তখন কী করবে?

পোস্টম্যানের URL বক্সের ঠিক নিচেই Headers নামে একটি ট্যাব থাকে। সেখানে তুমি নিজের ইচ্ছামতো কাস্টম Key-Value জোড়া যোগ করতে পারো। লেকচারে একটি কাস্টম হেডার পাঠানো হয়েছে:

  • Key: Authorization
  • Value: 101

Backend Code Implementation: সার্ভার সাইডে এই কাস্টম হেডারটি রিড করার জন্য আমরা context.Request.Headers ডিকশনারিটি ব্যবহার করব এবং মেথড রান করার আগে ContainsKey() দিয়ে প্রটেকশন লেয়ার তৈরি করব।

// Program.cs
using Microsoft.AspNetCore.Http;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
app.Run(async (HttpContext context) =>
{
    // 1. Setting Content-Type to text/plain for raw token output
    context.Response.Headers.ContentType = "text/plain";
 
    string authHeaderOutput = "No Authorization Header Found";
 
    // 2. Checking if the Custom Header "Authorization" exists in the request
    // Reminder: Headers are case-insensitive
    if (context.Request.Headers.ContainsKey("Authorization"))
    {
        // 3. Reading the value of the custom header
        string token = context.Request.Headers["Authorization"]!;
        authHeaderOutput = $"Successfully authorized! Token value is: {token}";
    }
    else
    {
        // Setting 401 Unauthorized status if token is missing
        context.Response.StatusCode = StatusCodes.Status401Unauthorized;
    }
 
    // 4. Writing the result to the response body
    await context.Response.WriteAsync(authHeaderOutput);
});
 
app.Run();

Testing Result: পোস্টম্যান থেকে Authorization: 101 লিখে রিকোয়েস্ট পাঠালে, কন্ডিশনটি ট্রু (true) হবে এবং রেসপন্স বডিতে Successfully authorized! Token value is: 101 লেখাটি চলে আসবে, যা প্রমাণ করে ব্যাকএন্ড সফলভাবে পোস্টম্যানের কাস্টম হেডার রিড করতে পেরেছে।

🔍 VS Code Shortcuts & Tips for Fedora Linux

লেকচারে ভিজ্যুয়াল স্টুডিও এবং উইন্ডোজের কথা বলা হলেও, তুমি যেহেতু Fedora Linux এবং VS Code ব্যবহার করছো, তোমার ডেভ-এনভায়রনমেন্টের জন্য নিচের টিপসগুলো অত্যন্ত কার্যকরী:

  • Installing Postman on Fedora: ফেডারায় পোস্টম্যান ইনস্টল করার সবচেয়ে সহজ উপায় হলো Flatpak বা Snap ব্যবহার করা। টার্মিনালে রান করতে পারো: flatpak install flathub com.getpostman.Postman।
  • VS Code Run/Debug Shortcut: তোমার .NET প্রজেক্টটি রান বা ডিবাগ করার ডিফল্ট কীবোর্ড শর্টকাট হলো F5।
  • Format Code Document: তোমার C# কোড ফাইলটি চমৎকারভাবে গুছিয়ে সাজানোর শর্টকাট হলো Shift + Alt + F।
  • Multi-cursor Editing: কোডে একসাথে একাধিক লাইনে টাইপ বা এডিট করার জন্য Alt কিউওয়ার্ড চেপে ধরে মাউস দিয়ে ক্লিক করতে পারো।

🚀 Best Practices & .NET 10 / C# 13 Updates

Best Practices with Examples

  1. Do Not Send Sensitive Keys in Plain Text: Authorization হেডারে কখনো প্লেইন টেক্সট বা সাধারণ পাসওয়ার্ড পাঠাবে না। এপিআই স্ট্যান্ডার্ড অনুযায়ী সবসময় Bearer <token> ফরম্যাট ব্যবহার করা উচিত।
  2. Always Use Header Constants instead of String: কোডে সরাসরি "Authorization" স্ট্রিং হার্ডকোড না করে Microsoft.Net.Http.Headers.HeaderNames ক্লাস ব্যবহার করা বেস্ট প্র্যাকটিস, এটি টাইপিং মিসটেক দূর করে।
// Bad Practice
if (context.Request.Headers.ContainsKey("Authorization")) { ... }
 
// Good Practice (Type-safe)
if (context.Request.Headers.ContainsKey(Microsoft.Net.Http.Headers.HeaderNames.Authorization)) { ... }

Modern .NET 10 / C# 13 Approaches

লেকচারে লো-লেভেল মিডলওয়্যার পাইপলাইন ব্যবহার করে হেডার রিড করা হয়েছে। কিন্তু আধুনিক .NET 10 এবং C# 13-এ আমরা এপিআই গেটওয়ে বা কন্ট্রোলারে এত জটিল কোড লিখি না। কাস্টম রিকোয়েস্ট হেডার রিড করার জন্য আমরা Minimal APIs এবং [FromHeader] Attribute ব্যবহার করি, যা কোডকে অবিশ্বাস্য রকমের ক্লিন এবং ফাস্ট করে।

.NET 10 Modern Code Example:

// Program.cs (.NET 10 Standard Minimal API Architecture)
using Microsoft.AspNetCore.Mvc;
 
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
 
// Minimal API automatically extracts the "Authorization" header and binds it to the parameter!
// No manual dictionary contains check needed.
app.MapGet("/secure-data", ([FromHeader(Name = "Authorization")] string? authToken) =>
{
    // Using C# 13 Null Coalescing or Pattern Matching
    if (string.IsNullOrWhiteSpace(authToken))
    {
        return Results.Unauthorized(); // Returns standard 401 Unauthorized Response
    }
 
    // Process logic securely
    return Results.Ok(new { Message = "Access Granted", SecretKey = authToken });
});
 
app.Run();

Why this is the modern way: এখানে আমাদের কোনো ম্যানুয়াল Headers.ContainsKey চেক করতে হয়নি। .NET 10 ফ্রেমওয়ার্ক নিজে থেকেই [FromHeader] মেকানিজম ব্যবহার করে অত্যন্ত হাই-স্পিডে আধুনিক HTTP/3 প্রোটোকল মেনে রিকোয়েস্ট হেডারটি এক্সট্র্যাক্ট করে ল্যাম্বডা প্যারামিটারে পুশ করে দেয়। এর ফলে কোড মেইনটেইন করা অনেক সহজ হয়।

Graph View

Backlinks