za.gl ලාංඡනය

API ලේඛන

ඔබේ කේතයෙන් කෙලින්ම සබැඳි කෙටි කරන්න. එක් අන්ත ලක්ෂ්‍යයක්, එක් bearer ටෝකනයක්.

අන්ත ලක්ෂ්‍යය

POSThttps://za.gl/api/shorten
RESTJSON බඳBearer සත්‍යාපනය

සත්‍යාපනය

ඔබේ API ටෝකනය Authorization ශීර්ෂකයේ bearer ටෝකනයක් ලෙස යවන්න. ඔබේ පළමු සබැඳිය සෑදූ පසු ගිණුම් උපකරණ පුවරුවෙන් එය ලබා ගන්න.

ශීර්ෂකය
Authorization: Bearer YOUR_API_TOKEN

තවම ටෝකනයක් නැද්ද? ඔබට එය නොමැතිව අන්ත ලක්ෂ්‍යය කැඳවිය හැකියි. Za.gl එසැණින් නිර්නාමික ගිණුමක් සාදා නව ටෝකනයක් ආපසු එවයි, මෙහි: data.newAuthToken. ඔබේ සබැඳි පසුව කළමනාකරණය කිරීමට එය සුරකින්න.

ඉල්ලීමේ බඳ

originalUrlඅවශ්‍යයි

string

කෙටි කිරීමට ඇති දිගු URL එක. ප්‍රොටෝකෝලය අත් හැරියොත්, 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

සබැඳිය සමඟ ගබඩා වන විකල්ප පාරදත්ත.

generateQR

boolean

කෙටි URL එකට 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 යන්නයි, කෙටි URL එක තිබෙන්නේ මෙහි: 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/minඑක් සේවාලාභියෙකුට මිනිත්තුවකට ඉල්ලීම් 10 ක් දක්වා.
409අභිරුචි අන්වර්ථය දැනටමත් ගෙන ඇත.
400වලංගු නොවන URL එකක් හෝ ගත වූ කල් ඉකුත්වීමේ දිනයක්.
429ඔබ අනුපාත සීමාවට හෝ මාසික කෝටාවට ළඟා වී ඇත.