သင့်ရဲ့ ပထမဆုံး Postman Request

နားလည်ထားရမယ့် အချက်

API တစ်ခုကို လက်ဖြင့် စမ်းသပ်ရာမှာ အခြေခံ လှုပ်ရှားမှု အနည်းငယ်ပဲ ရှိပါတယ် — request တည်ဆောက်ခြင်း၊ ပို့ခြင်း၊ ပြန်လာတာဖတ်ခြင်း။ ယခင် course က curl နဲ့ ပြသခဲ့ပါတယ်။ Postman ကလည်း visual interface ကနေ အလုပ်တူတူ လုပ်ပါတယ် — API client တစ်ခုပဲ၊ HTTP နားလည်ဖို့ အစားထိုးလို့ မရပါ။

Postman workflow တစ်ခုက request အသစ်ကနေ စပါတယ်။ HTTP method ရွေးပြီး၊ URL အပြည့်အစုံ ရိုက်ထည့်ပြီး၊ endpoint က လိုချင်တာတွေ (query parameters, custom headers, JSON body) ထည့်ပါတယ်။ ဒါက Postman မှာပဲ ထူးခြားတာ မဟုတ်ပါ — curl လိုအပ်တာနဲ့ တူပါတယ်၊ field တွေထဲမှာ စုစည်းထားတာပါ။

Request ပို့တာက action တစ်ခုတည်းပါပဲ။ Postman က curl ဒါမှမဟုတ် browser လုပ်သလိုပဲ network ပေါ်ကနေ ပို့ပြီး response ကို ခင်းပြပေးပါတယ် — အပေါ်ဆုံးမှာ status code၊ tab တစ်ခုမှာ headers၊ နောက်တစ်ခုမှာ body (JSON)။

status၊ headers၊ body ဆိုတဲ့ သုံးပိုင်း ကြည့်တဲ့ အလေ့အကျင့်ကသာ အရေးကြီးပါတယ်။ status က အောင်မြင်/မအောင်မြင်ကို အရင်ပြောပါတယ်။ headers က response ကိုယ်တိုင်အကြောင်း ဖော်ပြပါတယ်။ body ကတော့ တကယ့် data သို့မဟုတ် error ပါ။ Postman က ဒီသုံးခုကို ပိုမြန်စွာ မြင်ရအောင် ပေးထားတာပါ။

POSTMAN REQUEST WORKFLOW
------------------------
CREATE REQUEST
      |
      v
CHOOSE METHOD  (GET, POST, PUT, DELETE, ...)
      |
      v
ENTER URL      (https://api.example.com/users/42)
      |
      v
SEND
      |
      v
INSPECT RESPONSE
   +-- STATUS CODE   (200, 404, 500, ...)
   +-- HEADERS       (content-type, rate limits, ...)
   +-- BODY          (JSON data or error message)

လက်တွေ့ scenario နဲ့ ချိတ်ကြည့်မယ်

Public API တစ်ခုက user record တစ်ခုအတွက် fields မှန်ကန်စွာ ပြန်ပေးလား သိချင်တယ်ဆိုပါစို့။ GET request ဖန်တီးပြီး endpoint URL ကို paste လုပ်ပြီး Send နှိပ်ပါ။ response panel မှာ 200၊ JSON content-type header၊ လိုချင်တဲ့ fields ပါတဲ့ body ကို မြင်ရပါလိမ့်မယ်။

အခု endpoint က API key လိုအပ်တယ်ဆိုပါစို့။ curl ရဲ့ -H flag နဲ့ တူတူပဲ header field အနေနဲ့ ထည့်ပြီး ပြန်ပို့ပါ။ 200 အစား 401 ရလာရင် body ကိုမှ မဖွင့်ခင် တစ်ခုခုမှားနေတာ သိရမှာပါ။

• Postman ဟာ API client အများထဲက တစ်ခုပါပဲ — curl သင်ပြီးသား request/response model ကို visual အနေနဲ့ ပြသထားတာပါ။
• Postman workflow ကတော့: request ဖန်တီးပါ၊ method ရွေးပါ၊ URL ထည့်ပါ၊ Send နှိပ်ပါ၊ status/headers/body စစ်ပါ။
• status၊ headers၊ body သုံးခုလုံးကို အမြဲ အတူတကွ စစ်ပါ — 200 ရပေမယ့် body မှားနေရင် bug ပါပဲ။

အတူတူ စမ်းရေးကြည့်မယ်

// Illustrative only — this is NOT executed here. It represents what
// you would configure in Postman's request builder, and what the
// response panel would show back after clicking Send.

const request = {
  method: "GET",
  url: "https://api.example.com/users/42",
  headers: {
    Authorization: "Bearer <token>",
  },
};

// After Send, the response panel would display something like this:
const response = {
  status: 200,
  statusText: "OK",
  headers: {
    "content-type": "application/json",
    "x-ratelimit-remaining": "59",
  },
  body: {
    id: 42,
    name: "Aye Aye",
    email: "aye@example.com",
  },
};

ဒီ code ကို run လုပ်တာ မဟုတ်ပါဘူး — ပုံစံကိုသာ ပြသနေတာပါ။ တကယ့် Postman window မှာဆိုရင် response panel ရဲ့ အပေါ်ဆုံးမှာ "200 OK" ကို မြင်ရပြီး၊ Headers tab မှာ content-type နဲ့ rate-limit fields တွေ ပါတဲ့ list၊ Body tab မှာတော့ အထက်က JSON ကို syntax-highlight ပြီး ဖတ်ရလွယ်အောင် ပြသထားပါလိမ့်မယ်။

Postman Docs — Send Requests — API Integration & Webhooks