Postman: এটি কী, API পরীক্ষা এবং রিকোয়েস্ট নিয়ে কাজ করা

Postman কী এবং মূল বৈশিষ্ট্য

Postman হলো API ডেভেলপমেন্ট ও পরীক্ষার একটি প্ল্যাটফর্ম, যা ডেস্কটপ অ্যাপ্লিকেশন (Windows, macOS, Linux) এবং ওয়েব সংস্করণ হিসেবে উপলব্ধ। ২০১২ সালে Chrome এক্সটেনশন হিসেবে তৈরি হওয়া Postman বর্তমানে মনিটরিং, mock-সার্ভার এবং ক্লায়েন্ট কোড জেনারেশন সমর্থনসহ একটি পূর্ণাঙ্গ ইকোসিস্টেমে পরিণত হয়েছে।

রিকোয়েস্ট ও রেসপন্স ফরম্যাট

Postman সব HTTP মেথড সমর্থন করে: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS। রিকোয়েস্টের বডি JSON, XML, form-data, x-www-form-urlencoded এবং binary ফরম্যাটে হতে পারে। রেসপন্স সিনট্যাক্স হাইলাইটিং, Pretty-print এবং র হেডার দেখার ক্ষমতাসহ প্রদর্শিত হয়।

অথেনটিকেশন সমর্থন

অন্তর্নির্মিত অথেনটিকেশন টাইপগুলোর মধ্যে Bearer Token, Basic Auth, Digest Auth, OAuth 1.0, OAuth 2.0, API Key এবং AWS Signature অন্তর্ভুক্ত। Postman নির্বাচিত টাইপ অনুযায়ী Authorization হেডার স্বয়ংক্রিয়ভাবে যোগ করে, যা টোকেন ম্যানুয়ালি কপি না করেই সুরক্ষিত এন্ডপয়েন্ট পরীক্ষা দ্রুত করে।

Postman ইন্টারফেস এবং নেভিগেশন

Postman ইন্টারফেস-এ সাইড প্যানেল (Collections, APIs, Environments), কাজের এলাকা (Request Builder/Response Viewer) এবং নিচের প্যানেল (Console, Runner) থাকে। Params ট্যাব টেবিল ভিউতে URL-এর query-প্যারামিটার সম্পাদনা করতে দেয়, আর Headers ট্যাব HTTP হেডার পরিচালনা করে।

Postman Console

Console (View → Show Postman Console) মধ্যবর্তী রিডাইরেক্ট ও হেডারসহ সব নেটওয়ার্ক রিকোয়েস্ট ও রেসপন্স কালানুক্রমিকভাবে লগ করে। জটিল OAuth ফ্লো এবং রিডাইরেক্ট চেইন ডিবাগ করার সময় এটি অপরিহার্য, যখন স্ট্যান্ডার্ড Response Viewer শুধু চূড়ান্ত ফলাফল দেখায়।

Workspaces এবং টিমওয়ার্ক

Postman Fork ও Merge-এর মাধ্যমে কালেকশন ভার্সনিংসহ টিম ওয়ার্কস্পেস সমর্থন করে। টিম সদস্যরা রিকোয়েস্টে মন্তব্য করতে পারে, পরিবর্তন প্রস্তাব করতে পারে এবং রিয়েল-টাইমে কালেকশন সিঙ্ক করতে পারে। Public Workspace বহিরাগত ডেভেলপারদের জন্য API ডকুমেন্টেশন প্রকাশ করতে দেয়।

HTTP রিকোয়েস্ট তৈরি ও পাঠানো

Postman-এ বেসিক রিকোয়েস্ট HTTP মেথড নির্বাচন করে এবং অ্যাড্রেস বারে URL লিখে তৈরি করা হয়। পাঠানোর পর, রেসপন্স নিচের প্যানেলে স্ট্যাটাস কোড, এক্সিকিউশন সময় এবং আকারসহ প্রদর্শিত হয়। রিকোয়েস্ট প্যারামিটার টাইপ করার সময় স্বয়ংক্রিয়ভাবে এনকোড হয়।

ডায়নামিক ভেরিয়েবল এবং স্নিপেট

URL এবং রিকোয়েস্ট বডিতে {{$variable}} ফরম্যাটের ডায়নামিক ভেরিয়েবল ব্যবহার করা যায়। অন্তর্নির্মিত ভেরিয়েবল {{$guid}}, {{$timestamp}} এবং {{$randomInt}} প্রতিটি রিকোয়েস্টের জন্য অনন্য মান তৈরি করে। কোড স্নিপেট Code বাটনের () মাধ্যমে পাওয়া যায়, যা cURL, Python, JavaScript, Kotlin, Swift এবং অন্যান্য ভাষায় সমতুল্য রিকোয়েস্ট তৈরি করে।

// Pre-request-এ স্ক্রিপ্টের উদাহরণ: HMAC স্বাক্ষর তৈরি
const timestamp = Date.now().toString();
const secret = pm.environment.get("api_secret");
const hash = CryptoJS.HmacSHA256(timestamp, secret);
pm.request.headers.add({
    key: "X-Signature",
    value: hash.toString()
});

কালেকশন এবং এনভায়রনমেন্ট ভেরিয়েবল

কালেকশন হলো সম্পর্কিত রিকোয়েস্টের গ্রুপ, যা প্রকল্প বা কার্যকরী মডিউল অনুযায়ী একত্রিত হয়। প্রতিটি কালেকশনে নেস্টেড ফোল্ডার, শেয়ার্ড হেডার এবং Pre-request স্ক্রিপ্ট থাকতে পারে, যা কালেকশনের প্রতিটি রিকোয়েস্টের আগে চলে। রিকোয়েস্টের ক্রম ড্র্যাগ করার মাধ্যমে নির্ধারিত হয়।

এনভায়রনমেন্ট ভেরিয়েবল এবং গ্লোবাল ভেরিয়েবল

Postman পাঁচটি ভেরিয়েবল স্তর সমর্থন করে: global, collection, environment, data এবং local। দ্বন্দ্ব সমাধানের অগ্রাধিকার — লোকাল থেকে গ্লোবাল পর্যন্ত। এনভায়রনমেন্ট ফাইলে বিভিন্ন পরিবেশের জন্য key-value জোড়া থাকে: development, staging, production। এনভায়রনমেন্ট পরিবর্তন করলে সব URL এবং টোকেন স্বয়ংক্রিয়ভাবে বদলে যায়।

স্ক্রিপ্টের মাধ্যমে API পরীক্ষা স্বয়ংক্রিয় করা

Postman Tests ট্যাবে JavaScript-এ টেস্ট লেখার সুযোগ দেয়, যা রেসপন্স পাওয়ার পর চলে। টেস্টগুলো স্ট্যাটাস কোড, রেসপন্স বডি, হেডার এবং এক্সিকিউশন সময় যাচাই করে। ফলাফল Test Results প্যানেলে রঙিন পাস ইন্ডিকেটরসহ প্রদর্শিত হয়।

pm লাইব্রেরি এবং রিকোয়েস্ট চেইনিং

pm অবজেক্ট রেসপন্স নিয়ে কাজ করার পদ্ধতি প্রদান করে: pm.response, pm.expect, pm.variables। রিকোয়েস্ট চেইনিং একটি রিকোয়েস্টের রেসপন্স থেকে ডেটা ভেরিয়েবলে সংরক্ষণ করে পরের রিকোয়েস্টে ব্যবহারের মাধ্যমে বাস্তবায়িত হয়। এটি ইন্টিগ্রেশন টেস্ট তৈরি এবং API কলের ক্রমের মাধ্যমে ব্যবসায়িক লজিক যাচাইয়ের ভিত্তি।

// টেস্ট: রেসপন্স স্ট্রাকচার যাচাই এবং টোকেন সংরক্ষণ
pm.test("Status code is 200", () => {
    pm.response.to.have.status(200);
});

const json = pm.response.json();
pm.environment.set("auth_token", json.data.token);

Collection Runner এবং Newman

Collection Runner কালেকশনের সব রিকোয়েস্ট ক্রমান্বয়ে চালায়, প্রতিটি ধাপে টেস্ট সম্পাদন করে। Newman হলো CI/CD পাইপলাইন (Jenkins, GitHub Actions, GitLab CI) এর জন্য Postman-এর কনসোল সংস্করণ। Newman মনিটরিং সিস্টেমের সাথে ইন্টিগ্রেশনের জন্য JSON, JUnit এবং HTML ফরম্যাটে রিপোর্ট এক্সপোর্ট করে।

GraphQL এবং WebSocket নিয়ে কাজ করা

Postman-এ GraphQL রিকোয়েস্ট JSON ফরম্যাটের বডিসহ একটি একক এন্ডপয়েন্টে POST-এর মাধ্যমে পাঠানো হয়। GraphQL (Beta) ট্যাব সিনট্যাক্স হাইলাইটিং, ফিল্ড অটোকমপ্লিশন এবং স্কিমাসহ ভিজ্যুয়াল এডিটর প্রদান করে। রিকোয়েস্ট ভেরিয়েবল আলাদা Variables প্যানেলে পাঠানো হয়।

WebSocket এবং Socket.IO পরীক্ষা

Postman মেসেজ প্যানেলসহ একটি আলাদা ইন্টারফেসের মাধ্যমে WebSocket সংযোগ সমর্থন করে। টেক্সট ও বাইনারি মেসেজ পাঠানো যায়, সংযোগের ইতিহাস দেখা যায় এবং সংযোগ বিচ্ছিন্ন হলে স্বয়ংক্রিয়ভাবে পুনরায় সংযোগ করা যায়। Socket.IO ক্লায়েন্ট Engine.IO প্রোটোকলের সাথে সামঞ্জস্যপূর্ণ মোডে কাজ করে।

// pm API-এর মাধ্যমে Postman-এ WebSocket টেস্ট
const ws = new WebSocket("wss://echo.websocket.org");
ws.onmessage = (event) => {
    pm.test("Echo response received", () => {
        pm.expect(event.data).to.eql("Hello");
    });
};

Postman-এ Mock-সার্ভার এবং মনিটরিং

Postman-এর Mock-সার্ভার বিদ্যমান কালেকশনের ভিত্তিতে API এন্ডপয়েন্ট অনুকরণ করার সুযোগ দেয়। এটি তখন উপযোগী, যখন ব্যাকএন্ড এখনো প্রস্তুত নয়, কিন্তু ফ্রন্টএন্ড বা মোবাইল অ্যাপ ইতিমধ্যে তৈরি হচ্ছে। Mock-সার্ভার সঠিক হেডার এবং স্ট্যাটাস কোডসহ কালেকশন থেকে নমুনা রেসপন্স ফেরত দেয়।

Mock-সার্ভার তৈরি

Mock-সার্ভার এক ক্লিকে কালেকশন থেকে তৈরি হয়: কালেকশন নির্বাচন করুন → Mock Servers → Add a new mock server। Postman একটি অনন্য URL তৈরি করে, যা প্রকৃত API-এর পরিবর্তে অ্যাপ্লিকেশন কোডে ব্যবহার করা যায়। কালেকশনের প্রতিটি রিকোয়েস্টের জন্য মক সংরক্ষিত Example Response ফেরত দেয়, যা ব্যাকএন্ড শেষ হওয়ার আগেই UI যাচাই করতে দেয়।

Postman Monitors-এর মাধ্যমে API মনিটরিং

Monitors কালেকশন সময়সূচিতে (প্রতি ৫ মিনিট, ঘণ্টা বা দিনে) চালায় এবং API-এর প্রাপ্যতা ও সঠিকতা যাচাই করে। টেস্ট ব্যর্থ হলে, মনিটর ইমেইল বা Slack-এ নোটিফিকেশন পাঠায়। মনিটরিং Postman ক্লাউড থেকে কাজ করে, আলাদা সার্ভারের প্রয়োজন হয় না এবং ফ্রি প্ল্যানে মাসে ১০,০০০ পর্যন্ত রিকোয়েস্ট সমর্থন করে।

// মনিটরিংয়ের জন্য টেস্ট: রেসপন্স সময় যাচাই
pm.test("Response time < 2000ms", () => {
    pm.expect(pm.response.responseTime).to.be.below(2000);
});

pm.test("Content-Type is JSON", () => {
    pm.response.to.have.header("Content-Type");
});

নিরাপত্তা এবং সিক্রেট ব্যবস্থাপনা

Postman API কী নিয়ে নিরাপদ কাজের জন্য প্রক্রিয়া প্রদান করে। Secret টাইপের ভেরিয়েবল এনক্রিপ্টেড থাকে এবং ইন্টারফেসে প্রদর্শিত হয় না। টিম কাজের জন্য Admin, Editor এবং Viewer রোলসহ Workspace ব্যবহার করুন।

ভেরিয়েবল এনক্রিপ্ট করা

এনভায়রনমেন্ট ভেরিয়েবল তৈরি করার সময় Secret টাইপ নির্বাচন করুন — সব ইন্টারফেসে মান তারকাচিহ্ন দিয়ে লুকানো থাকে। সিক্রেট শেয়ার করার সময় কালেকশনে এক্সপোর্ট হয় না এবং Newman লগে প্রদর্শিত হয় না। পাসওয়ার্ড ও টোকেন শুধুমাত্র Secret ভেরিয়েবলে সংরক্ষণ করার পরামর্শ দেওয়া হয়।

Vault ইন্টিগ্রেশন

Postman HashiCorp Vault এবং AWS Secrets Manager-এর সাথে ইন্টিগ্রেশন সমর্থন করে। Pre-request স্ক্রিপ্ট বাহ্যিক স্টোরেজ থেকে সিক্রেট গতিশীলভাবে অনুরোধ করতে পারে, যা কালেকশন এনভায়রনমেন্ট ফাইলে সংবেদনশীল ডেটা সংরক্ষণ এড়ায়।

নিরাপত্তা এবং সিক্রেট ব্যবস্থাপনা

Postman API কী নিয়ে নিরাপদ কাজের জন্য প্রক্রিয়া প্রদান করে। Secret টাইপের ভেরিয়েবল এনক্রিপ্টেড থাকে এবং ইন্টারফেসে প্রদর্শিত হয় না। টিম কাজের জন্য Admin, Editor এবং Viewer রোলসহ Workspace ব্যবহার করুন।

ভেরিয়েবল এনক্রিপ্ট করা

এনভায়রনমেন্ট ভেরিয়েবল তৈরি করার সময় Secret টাইপ নির্বাচন করুন — সব ইন্টারফেসে মান তারকাচিহ্ন দিয়ে লুকানো থাকে। সিক্রেট শেয়ার করার সময় কালেকশনে এক্সপোর্ট হয় না এবং Newman লগে প্রদর্শিত হয় না। পাসওয়ার্ড ও টোকেন শুধুমাত্র Secret ভেরিয়েবলে সংরক্ষণ করার পরামর্শ দেওয়া হয়।

Vault ইন্টিগ্রেশন

Postman HashiCorp Vault এবং AWS Secrets Manager-এর সাথে ইন্টিগ্রেশন সমর্থন করে। Pre-request স্ক্রিপ্ট বাহ্যিক স্টোরেজ থেকে সিক্রেট গতিশীলভাবে অনুরোধ করতে পারে, যা কালেকশন এনভায়রনমেন্ট ফাইলে সংবেদনশীল ডেটা সংরক্ষণ এড়ায়।