API ကို စတင်အသုံးပြုခြင်း
API key တစ်ခုနဲ့ သင့်ကိုယ်ပိုင် tool များကို FOM နဲ့ ချိတ်ပြီး ပထမဆုံး request ကို ပို့ကြည့်ပါ။
FOM API က POS၊ ဝက်ဘ်ဆိုက်၊ စာရင်းဇယား ဒါမှမဟုတ် script လို သင့်ကိုယ်ပိုင် tool တွေကို ဆိုင်ရဲ့ အော်ဒါ၊ ဖောက်သည်၊ ပစ္စည်း၊ လက်ကျန်နဲ့ ပို့ဆောင်မှုတွေကို ဖတ်ပြီး ပြင်ခွင့် ပေးပါတယ်။ တစ်ခုခု ပြောင်းတဲ့အခါ Webhook များ က သင့် tool တွေကို အသိပေးပါတယ်။
မစခင်
API အတွက် web ပေါ်က ငွေတောင်းခံမှု မှာ API အသုံးပြုခွင့် ထပ်တိုးကို ဝယ်ထားဖို့ လိုပါတယ်။ API key နဲ့ webhook တွေကို ပိုင်ရှင် ဒါမှမဟုတ် မန်နေဂျာ က ဆက်တင် → Developers မှာ စီမံပါတယ်။
API အသုံးပြုခွင့် ထည့်ပါ။ ငွေတောင်းခံမှု ကိုဖွင့်ပြီး အစီအစဉ် သို့မဟုတ် ထပ်ဆောင်း ပြောင်းရန် ကိုနှိပ်ကာ API အသုံးပြုခွင့် ကို ထည့်ပါ။ ထပ်တိုးများ ကို ကြည့်ပါ။
Key ပြုလုပ်ပါ။ ဆက်တင် → Developers ကိုဖွင့်ပြီး Key အသစ် ကို နှိပ်ပါ။ POS ချိတ်ဆက်မှု လို အမည်ပေးပြီး လိုတာကိုပဲ အမှန်ခြစ်ပါ။ Developers ဆက်တင် ကို ကြည့်ပါ။
Key ကို ကူးယူပါ။ fom_live_ နဲ့ စပြီး တစ်ကြိမ်သာ ပြပါတယ်။ ဥပမာ environment variable အဖြစ် သင့် server ပေါ်မှာပဲ ထားပါ -
export FOM_API_KEY="fom_live_…"စမ်းကြည့်ပါ။ Key က ဘယ်ဆိုင်အတွက်လဲ မေးကြည့်ပါ -
curl https://api.getfom.com/public/v1/shop \
-H "Authorization: Bearer $FOM_API_KEY"{
"success": true,
"data": {
"shop": { "id": "…", "name": "Ma Aye Shop", "timezone": "Asia/Yangon" },
"api_key": { "name": "POS sync", "scopes": ["orders:read"], "acts_for": "Ma Aye" }
},
"meta": { "request_id": "req_7f3a2c", "timestamp": "2026-11-25T08:00:00.000Z" }
}နောက်ဆုံး အော်ဒါများကို ကြည့်ပါ -
curl "https://api.getfom.com/public/v1/orders?limit=5" \
-H "Authorization: Bearer $FOM_API_KEY"လုပ်နိုင်တာများ
| အပိုင်း | ဖတ်ခြင်း | ပြင်ခြင်း |
|---|---|---|
| အော်ဒါ | အော်ဒါများ စာရင်း၊ sync နဲ့ တစ်ခုချင်း ကြည့်ခြင်း | အော်ဒါ ဖန်တီးခြင်း၊ အခြေအနေ ပြောင်းခြင်း |
| ဖောက်သည် | ဖောက်သည်များ စာရင်း၊ sync နဲ့ တစ်ယောက်ချင်း ကြည့်ခြင်း | ဖောက်သည် ထည့်ခြင်း၊ ပြင်ခြင်း |
| ပစ္စည်း | Variant နဲ့ လက်ကျန်ပါ ပစ္စည်းများ | ပစ္စည်း ထည့်ခြင်း၊ ပြင်ခြင်း၊ လက်ကျန် ပြောင်းခြင်း |
| ပို့ဆောင်မှု | ပို့ဆောင်မှုများ စာရင်း၊ sync နဲ့ တစ်ခုချင်း ကြည့်ခြင်း | ပို့ဆောင်မှု အခြေအနေ ဒါမှမဟုတ် အချိန် ပြောင်းခြင်း |
API ကနေ လုပ်တဲ့ ပြောင်းလဲမှုတွေက FOM ထဲမှာ လုပ်သလိုပဲ အလုပ်လုပ်ပါတယ်။ အော်ဒါ အတည်ပြုရင် လက်ကျန် နုတ်ပြီး ပို့ဆောင်မှု ရောက်ပြီဆိုရင် အော်ဒါလည်း ပြောင်းကာ ဖောက်သည်တွေလည်း အတူတူ စာရပါတယ်။ လုပ်ဆောင်ချက် မှတ်တမ်း မှာ Ma Aye via API key 'POS sync' လို ပြပါတယ်။
နောက်ထပ်
- Authentication နဲ့ scope များ - key တွေ ဘယ်လို အလုပ်လုပ်လဲ၊ scope တစ်ခုချင်း ဘာခွင့်ပြုလဲ။
- Request နဲ့ error များ - response ပုံစံ၊ error code နဲ့ rate limit။
- Pagination နဲ့ sync - အားလုံး ဒါမှမဟုတ် ပြောင်းတာကိုပဲ ဖတ်ခြင်း။
- TypeScript SDK - Node.js နဲ့ တခြား JavaScript runtime များအတွက် အဆင်သင့် client။