za.gl လိုဂို

API စာရွက်စာတမ်း

သင့်ကုဒ်ထဲကနေ တိုက်ရိုက် လင့်တိုပါ။ endpoint တစ်ခု၊ bearer တိုကင်တစ်ခု။

Endpoint

POSThttps://za.gl/api/shorten
RESTJSON ဒေတာကိုယ်ထည်Bearer auth

အထောက်အထား စိစစ်ခြင်း

သင့် API တိုကင်ကို Authorization header ထဲတွင် bearer တိုကင်အဖြစ် ထည့်ပါ။ ပထမလင့် ဖန်တီးပြီးနောက် သင့်အကောင့် ဒက်ရှ်ဘုတ်တွင် ရယူနိုင်သည်။

Header
Authorization: Bearer YOUR_API_TOKEN

တိုကင် မရှိသေးဘူးလား။ မပါဘဲလည်း endpoint ကို ခေါ်နိုင်သည်။ Za.gl က အမည်မဖော်သော အကောင့်တစ်ခုကို ချက်ချင်း ဖန်တီးပြီး တိုကင်အသစ်ကို ဒီအကွက်ထဲတွင် ပြန်ပေးသည်- data.newAuthToken. နောက်ပိုင်း လင့်များ စီမံနိုင်ရန် သိမ်းထားပါ။

တောင်းဆိုချက် body

originalUrlမဖြစ်မနေလို

string

တိုချုံ့မည့် URL အရှည်။ protocol မထည့်ပါက https:// ကို အလိုအလျောက် ထည့်ပေးသည်။

customAlias

string

သင့်ကိုယ်ပိုင် အဆုံးသတ်၊ ဥပမာ za.gl/my-link။ တစ်မူထူးခြားရမည်၊ မဟုတ်ပါက 409 ပြန်ရမည်။

password

string

လင့်ကို ကာကွယ်ပါ၊ ဝင်ရောက်သူများ ဆက်သွားရန် စကားဝှက် လိုအပ်မည်။

expiresAt

string (ISO date)

လင့် ရပ်တန့်ရမည့်အချိန်။ အနာဂတ်အချိန် ဖြစ်ရမည်။

expiresInMinutes / expiresInHours / expiresInDays

number

expiresAt အစား၊ သတ်မှတ်ထားသည့် အချိန်ကြာပြီးနောက် သက်တမ်းကုန်စေရန်။

waitTimer

number (0-300)

ပြန်လည်ညွှန်းမပေးမီ ကြိုကြည့်စာမျက်နှာတွင် ဝင်ရောက်သူ စောင့်ရမည့် စက္ကန့်။

customGtmId

string

ကြိုကြည့်စာမျက်နှာတွင် အလုပ်လုပ်မည့် သင့်ကိုယ်ပိုင် Google Tag Manager ID (GTM-XXXXXXX)။

title / description

string

လင့်နှင့်အတူ သိမ်းထားမည့် ရွေးချယ်နိုင်သော metadata။

generateQR

boolean

လင့်တိုအတွက် QR ကုဒ်ပါ ပြန်ပေးရန်။

တောင်းဆိုချက် နမူနာ

POSTcURL
curl -X POST https://za.gl/api/shorten \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "password": "optional-secret",
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "waitTimer": 5
  }'

တုံ့ပြန်ချက် နမူနာ

ခေါ်ဆိုမှု အောင်မြင်ပါက 200 OK ပြန်ပေးပြီး လင့်တိုကို ဒီအကွက်ထဲတွင် ထည့်ပေးသည်- data.shortUrl.

200 OKJSON
{
  "success": true,
  "message": "URL shortened successfully",
  "data": {
    "id": "123",
    "alias": "my-link",
    "shortUrl": "https://za.gl/my-link",
    "originalUrl": "https://example.com/a-very-long-link",
    "customAlias": "my-link",
    "domain": "za.gl",
    "title": "",
    "description": null,
    "hasPassword": true,
    "isActive": true,
    "expiresAt": "2026-12-31T23:59:59.000Z",
    "hits": 0,
    "waitTimer": 5,
    "created": "2026-06-25T10:00:00.000Z",
    "modified": "2026-06-25T10:00:00.000Z",
    "authToken": "your-account-token"
  }
}

နှုန်းကန့်သတ်ချက်နှင့် အမှားများ

10 req/minclient တစ်ခုလျှင် တစ်မိနစ်ကို တောင်းဆိုမှု 10 ခုအထိ။
409ဤ alias ကို အသုံးပြုပြီးသား ဖြစ်နေသည်။
400URL မမှန်ကန်ပါ သို့မဟုတ် သက်တမ်းကုန်ရက် လွန်နေပါသည်။
429နှုန်းကန့်သတ်ချက် သို့မဟုတ် လစဉ်ကန့်သတ်ချက် ပြည့်သွားပါပြီ။